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。
macOS 本地摄像头:列出设备 camsnap devices;快照 camsnap snap --device 0 --out webcam.jpg;查看 PTZ 位置与范围 camsnap ptz status --device 0;移动云台 camsnap ptz goto --device 0 --pan 45 --tilt -18,另支持 camsnap ptz move(相对增量)与 camsnap ptz home。
注意:需要 ffmpeg 在 PATH 中;建议长片段前先做短测试捕获;PTZ 需 macOS 摄像头权限,且因这类摄像头仅在流式传输时响应 UVC 控制,camsnap 会在操作期间保持捕获会话。运动命令会校验最终位置,若未到达则退出码非零;摄像头端 AI 构图可能覆盖手动定位,若移动持续失败可关闭跟踪。