clearcam：为任何安防摄像头添加目标检测、跟踪、移动端通知和搜索功能。

还没有 RTSP 摄像头？

试试这个视频源：https://webcam.elcat.kg/Too-Ashu_Tunnel_North/index.m3u8 (https://kg.camera)

（旧版）视频演示：

https://x.com/RoryClear/status/1959249250811785405

计算机要求

• Mac、Linux 或可能支持的 Windows 系统
• ffmpeg
• Python 3.11 或更高版本

从源码运行 NVR + Python 推理

1. 使用 pip install -r requirements.txt 安装依赖。
2. 运行 python3 clearcam.py。
3. （可选）输入您的 Clearcam 高级用户 ID（可在 iOS 应用设置页面查看），以接收实时流和通知。
4. 在浏览器中打开 localhost:8080。

• 第一次运行时，可使用 BEAM=2 python3 clearcam.py 以提升性能（首次运行会有等待时间）。

从源码安装 iOS 应用

1. 克隆仓库：git clone https://github.com/roryclear/clearcam.git。
2. 打开 ios/clearcam.xcodeproj。

iOS 要求

• iOS 15 或更高版本
• iPhone SE（第一代）或更新机型（较旧的 iPhone 可能也能运行）
• 无需额外依赖！

注册 Clearcam 高级会员

功能

• 远程查看您的实时摄像头画面。
• 接收事件通知（检测到物体/人员）。
• 远程查看事件录像片段。
• 所有数据均采用端到端加密。

如何注册

访问 clearcam.org 进行注册，或在 iOS 应用中升级至高级会员。

Clearcam 快速上手指南

Clearcam 是一款开源工具，可为任意安防摄像头（RTSP 流）添加物体检测、追踪、移动端通知及事件搜索功能。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：macOS、Linux（Windows 可能支持但非首选）。
• 核心依赖：
  • ffmpeg：用于视频流处理。
  • python3.11 或更高版本。
• 硬件建议：若需高性能推理，建议使用配备 Apple Silicon 的 Mac 或带有 GPU 的 Linux 机器。

提示：如果您暂时没有 RTSP 摄像头，可使用以下公开测试流进行体验： https://webcam.elcat.kg/Too-Ashu_Tunnel_North/index.m3u8

安装步骤

1. 获取源码与安装依赖

克隆项目仓库并安装 Python 依赖包：

git clone https://github.com/roryclear/clearcam.git
cd clearcam
pip install -r requirements.txt

(注：国内用户若遇到 pip 下载缓慢，可临时使用清华源：pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple)

2. 运行服务

启动 NVR（网络视频录像机）及推理引擎：

python3 clearcam.py

性能优化选项： 如果您的设备支持多核并行处理（如 Apple M 系列芯片），可添加 BEAM=2 参数以提升性能（首次运行会有短暂等待）：

BEAM=2 python3 clearcam.py

3. (可选) 配置 Premium 账户

若需接收远程推送通知或使用高级功能，可在运行时输入您的 Clearcam Premium userID（该 ID 可在 iOS 应用设置页面查看）。

基本使用

服务启动后，即可通过以下方式访问：

1. Web 端管理： 在浏览器中打开本地地址：

   http://localhost:8080
   

   在此界面您可以查看实时画面、检测区域设置（Zone）、事件回放及日志。

2. 移动端查看：

   • iOS：从源码构建或直接在 App Store 下载 "Clearcam" 应用。
     • 源码构建：打开 ios/clearcam.xcodeproj 编译安装。
     • 系统要求：iOS 15+，iPhone SE (第一代) 或更新机型。
   • Android：可在 Google Play 商店下载。

3. 功能验证：

   • 观察 Web 界面或手机 App 是否接收到实时流。
   • 当画面中出现人或物体时，检查是否触发检测框及移动端通知。

---

如需远程查看直播、接收事件通知剪辑及使用端到端加密功能，请访问 clearcam.org 注册 Premium 账户或在 iOS 应用中升级。