Clearcam:给现有摄像头接入目标检测和事件检索
Clearcam 是面向 RTSP 摄像头的开源 NVR,可在 Mac 或 Linux 上运行检测、事件通知和检索;远程流与通知涉及 Premium 服务。
项目资料
GitHub Ecosystem- 许可证
- GPL-3.0
- 主语言
- Python
- 星标
- 2,215
- 核查时间
- 2026-11-01
以上快照资料以核查当日为准,可能随版本或运营策略变化。
家里的 IP 摄像头已经能输出 RTSP 视频,想按人物或车辆查找事件时,常常还得换设备或购买厂商云服务。Clearcam 把 NVR 和目标检测程序放在一套 Python 项目里,连接现有摄像头后,可以在浏览器查看事件,也能把通知转发到自己选择的服务。GitHub README 还列出 iOS 客户端,并标注新加入 Qwen3 VL 通知摘要;截至 2026 年 11 月 1 日,仓库有 2,215 颗星,采用 GPL-3.0。

核心功能
Clearcam 将视频接入、事件检测和通知串在同一个 NVR 流程中。项目 README 展示了服务端网页与 iOS 事件列表;能否接入某台摄像头,仍取决于它提供的流和你的机器环境。
- 接入现有摄像头:项目面向网络摄像头视频流,可先用自己的 RTSP 地址测试;README 另提供公开隧道摄像头的 HLS 示例,作为没有设备时的试玩入口。
- 检测与回看:仓库描述包括对象检测、跟踪、事件片段和检索。README 的页面截图分别展示检测区域、事件列表和浏览器回放,适合按事件查看,而不是逐段拖动长录像。
- 自行接收通知:通知 URL 可以在设置中修改,README 提到 Home Assistant、Pushover、n8n,也附有一个示例通知服务器。接收端由使用者选择。
- 移动端入口:项目提供 iOS 应用源码,最低要求为 iOS 15;README 还列出 App Store 和 Google Play 下载入口。
- AI 摘要:README 标注支持使用 Qwen3 VL 生成通知摘要。现有说明没有给出硬件负载、准确率或支持对象清单,部署前应按自己的视频流验证。
典型使用场景
Clearcam 适合已经有网络摄像头、愿意自己维护一台 Mac 或 Linux 主机的家庭实验室用户。它可以把检测区域里的事件集中到一个网页或手机端查看,也能把事件通知送进 Home Assistant 或自建自动化流程。
如果你只想查看摄像头实时画面,原厂应用可能更省事;如果需要一套经过清晰文档验证的多摄像头部署方案,应该先和成熟 NVR 比较。Clearcam README 目前没有列出并发摄像头数、存储保留策略或部署基准,不能据此估算主机规格。
与 Deep Live Cam 这类处理单张图像或视频的人脸工具不同,Clearcam 的重点是长期连接摄像头并围绕事件工作。选择它前,先确认摄像头能输出可用的视频流,再决定检测、录像和通知分别放在哪台机器上。
快速上手
Clearcam README 给出的最短服务端流程需要 Python 3.11 或更新版本以及 FFmpeg:
pip install -r requirements.txt
python3 clearcam.py
启动后,在同一台机器的浏览器打开 http://localhost:8080。README 还建议在 GPU 没被自动使用时,通过 DEV=AMD 或 DEV=NV 指定设备;第一次启用 BEAM=2 会有等待时间。仓库标注 Mac 和 Linux 可用,Windows 当前仍提示需要修复 FFmpeg,因此不应把这套步骤当作 Windows 安装指南。
小结
Clearcam 值得已经持有 RTSP 摄像头、想尝试自管事件检测的人先在一台机器上试跑。它把浏览器 NVR、目标检测、通知出口和 iOS 客户端放在同一个项目中,README 也给出可直接运行的命令。仓库以 GPL-3.0 发布,主要语言是 Python;GitHub 数据核验于 2026 年 11 月 1 日。
先留意远程功能边界:README 要求在网页设置中填入 iOS 应用设置页可见的 Premium user ID,才能接收远程视频流与通知;端到端加密的说明也针对 Premium 功能。源码可自托管,并不自动说明所有远程数据都留在本机。摄像头含有敏感影像,正式使用前应检查数据路径、网络暴露方式和服务条款。项目也没有在 README 中提供硬件基准或多路稳定性指标,建议先用一条非敏感视频流验证资源占用和通知效果。