Camsnap

📸 RTSP 摄像头快照与录像利器

工具榜 #2

通过 RTSP/ONVIF 协议快速抓取摄像头快照与录像,支持运动检测和自动运维诊断,适合家庭安防与小型监控系统。

收藏
54.9k
安装
15.2k
版本
1.0.0
CLS 安全性认证2026-04-30
点击查看完整报告 >

使用说明

核心用法

camsnap 是一款面向 RTSP/ONVIF 协议网络摄像头的命令行工具,专注于快速抓取静态快照、录制视频片段及监控运动事件。

快速配置

  • 配置文件位于 ~/.config/camsnap/config.yaml
  • 添加摄像头:camsnap add --name <名称> --host <IP> --user <用户> --pass <密码>
  • 自动发现:camsnap discover --info

常用功能

  • 即时快照camsnap snap <camera> --out shot.jpg
  • 录制片段camsnap clip <camera> --dur 5s --out clip.mp4,支持自定义时长
  • 运动监控camsnap watch <camera> --threshold 0.2 --action '...',可设定灵敏度阈值并触发后续动作
  • 健康诊断camsnap doctor --probe 用于排查连接与配置问题

系统依赖:需要本地安装 ffmpeg 并确保其在 PATH 中可用。

---

显著优点

1. 协议兼容性强:原生支持 RTSP/ONVIF 标准协议,覆盖绝大多数消费级及商用网络摄像头
2. 工作流集成友好:纯命令行设计,易于与 HomeKit、Node-RED、Home Assistant 等自动化平台联动

3. 轻量高效:专注单一功能,无冗余 GUI,资源占用极低

4. 分发渠道正规:通过 Homebrew 官方 tap 分发(steipete/tap/camsnap),安装卸载便捷

5. 安全无风险:纯 Markdown Skill 结构,无可执行代码,零威胁发现

潜在缺点与局限性

  • 依赖外部工具:必须单独安装 ffmpeg,且版本兼容性可能影响编码功能
  • 配置门槛存在:需手动编辑 YAML 或命令行配置,对非技术用户不够友好
  • 功能相对单一:不支持云端存储、AI 识别、多路并发录制等高级特性
  • 无官方 GUI:纯 CLI 工具,不习惯终端的用户需借助第三方 wrapper
  • 个人开发者维护:项目由 steipete 个人维护,长期更新承诺未明确

适合人群

  • 家庭安防爱好者,需要本地化录像方案
  • 开发者/运维人员,需将摄像头集成至自动化工作流
  • 小型商铺,寻求低成本监控快照备份方案
  • 技术用户,偏好命令行工具及自托管方案

常规风险

  • 网络暴露风险:RTSP 流默认可能无加密传输,建议摄像头置于隔离 VLAN
  • 凭证管理:密码明文存储于本地配置文件,需确保文件权限安全(chmod 600
  • 存储空间:长时间 watch 或高频 clip 可能迅速占满磁盘,建议配合日志轮转
  • ffmpeg 兼容性:不同摄像头厂商的编码格式可能需特定 ffmpeg 版本或参数
  • 项目可持续性:T3 来源(个人开发者),虽分发渠道正规,但建议关注社区反馈与更新频率

Camsnap 内容

手动下载zip · 839 B
SKILL.mdtext/markdown
请选择文件