camsnap 是一款命令行工具,用于从 RTSP/ONVIF 摄像头抓取快照、视频片段或运动事件。
用途
camsnap 面向已配置摄像头的画面采集需求,可在命令行中完成单帧抓拍、短片录制以及运动监控。
主要能力
- 快照:从指定摄像头抓取一帧图像并保存为文件。
- 片段:从指定摄像头录制指定时长的视频片段。
- 运动监视:以阈值方式监视摄像头画面,并在触发时执行自定义动作。
- 设备发现:发现摄像头并查看信息。
- 诊断:通过探测排查摄像头配置或连接问题。
- 多摄像头配置:通过配置文件管理摄像头,并支持添加摄像头。
使用方式
配置文件位于 ~/.config/camsnap/config.yaml。
添加摄像头:camsnap add --name kitchen --host 192.168.0.10 --user user --pass pass
常用命令:
- 发现:camsnap discover --info
- 快照:camsnap snap kitchen --out shot.jpg
- 片段:camsnap clip kitchen --dur 5s --out clip.mp4
- 运动监视:camsnap watch kitchen --threshold 0.2 --action '...'
- 诊断:camsnap doctor --probe
适用场景
适用于需要从 RTSP/ONVIF 摄像头按需获取静态画面、短视频或监控运动事件的使用者,例如家庭或小型场所的摄像头画面采集。
限制
需要 ffmpeg 并位于 PATH 中。建议在进行较长片段录制前,先做一次短时测试采集。