clearcam

roryclearGPL-3.0活跃维护

给普通监控摄像头加上目标检测、跟踪、手机通知和录像搜索能力,支持 RTSP 接入,可自建 NVR 替代商业方案。

Add object detection, tracking, mobile notifications, and search to any security camera.

0.2.8发布于 2026-08-31 23:11 UTC2,264star +7 / 7 天227fork同步于 2026-11-10 17:46 UTC

怎么上手

由 README 提炼,执行前请确认
pip install -r requirements.txt
python3 clearcam.py
硬件要求按 README 说明

需要 Mac 或 Linux(Windows 因 ffmpeg 问题暂不支持),并安装 ffmpeg 与 Python 3.11+;README 未说明具体显存要求,默认用 GPU,CPU 被占用时可用 DEV=AMD 或 DEV=NV 指定显卡。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

给任意 RTSP 摄像头加上目标检测、跟踪、手机通知和 AI 摘要的自托管 NVR

给普通监控摄像头加上目标检测、跟踪、手机通知和录像搜索能力,支持 RTSP 接入,可自建 NVR 替代商业方案。

核心能力

  • 接入 RTSP 摄像头做目标检测与跟踪
  • 检测到人/物体时推送手机通知
  • 用 Qwen3 VL 生成 AI 通知摘要
  • 支持自定义通知 URL 对接 Home Assistant 等
  • 提供 iOS/Android App 远程看直播与事件片段

容易踩的坑

Windows 目前不可用,需要等 ffmpeg 修复;默认用 CPU 推理,需用 DEV=AMD 或 DEV=NV 才会走 GPU;远程查看和通知需在设置里填 Clearcam premium userID。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本0.2.8
  1. 0.2.8最新正式版2026-08-31 · 2026-08-31 23:11 UTC
    • Changed streams from .ts to .m4s
    • Scrubbing bugs removed
    • Time better synced across feeds
    • Faster startup time
  2. 0.2.72026-07-13 · 2026-07-13 18:07 UTC
    查看更新说明
    • Removed CLI setup
    • Added ability to change settings to during runtime
  3. 0.2.62026-05-29 · 2026-05-29 10:16 UTC
    查看更新说明

    Add Qwen3 VL notification summaries

  4. 0.2.52026-04-15 · 2026-04-15 09:59 UTC
    查看更新说明

    Face recognition added

  5. 0.2.42026-02-20 · 2026-02-20 11:19 UTC
    查看更新说明
    • Stable playback and scrubbing
    • Inference efficiency (wait for frame)
    • New descriptive alerts

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    clearcam: Add object detection, tracking, mobile notifications, AI summaries, and search to any security camera.

    Don't own an RTSP camera yet?

    Try it out with this feed: https://webcam.elcat.kg/Too-Ashu_Tunnel_North/index.m3u8 (https://kg.camera)

    (old) video demo:

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

    computer requirements

    • Mac, Linux, Windows *ffmpeg fix needed
    • ffmpeg
    • python3.11 or later

    run NVR + inference in python from source

    1. pip install -r requirements.txt
    2. python3 clearcam.py
    3. open localhost:8080 in your browser
    4. (optional) enter your Clearcam premium userID in the web UI settings (viewable in iOS app settings page) to receive streams and notifications
    • use DEV=AMD / DEV=NV python3 clearcam.py if your CPU is being used instead of your GPU
    • use BEAM=2 python3 clearcam.py for extra performance (wait time on first run)

    Bring your own notifications!

    install iOS App from source

    1. git clone https://github.com/roryclear/clearcam.git
    2. open ios/clearcam.xcodeproj

    iOS requirements

    • iOS 15 or newer
    • iPhone SE (1st gen) or newer (older iPhones might work)
    • dependencies: NONE!

    Signing Up for Clearcam Premium

    Features

    • View your live camera feeds remotely.
    • Receive notifications on events (objects/people detected).
    • View event clips remotely.
    • End-to-end encryption on all data.

    How to Sign Up

    Visit clearcam.org to sign up, or upgrade to premium in the iOS app.