camsnap
steipete/clawdis
Capture frames and clips from RTSP/ONVIF cameras via command line.
What is camsnap?
camsnap is a CLI tool for grabbing snapshots, video clips, and motion events from IP cameras. Use it to integrate camera feeds into automation workflows, security monitoring, or media capture pipelines.
- Capture single-frame snapshots from configured cameras
- Record video clips of specified duration
- Monitor cameras for motion events with configurable thresholds
- Discover and probe available cameras on the network
- Store captured media to disk with custom output paths
How to install camsnap
npx skills add https://github.com/steipete/clawdis --skill camsnap- ffmpeg installed and on PATH
- RTSP or ONVIF-compatible IP camera
- Camera credentials (host, username, password)
How to use camsnap
- 1.Install camsnap via brew: `brew install steipete/tap/camsnap`
- 2.Create config file at `~/.config/camsnap/config.yaml`
- 3.Add a camera: `camsnap add --name kitchen --host 192.168.0.10 --user user --pass pass`
- 4.Test discovery: `camsnap discover --info`
- 5.Capture a snapshot: `camsnap snap kitchen --out shot.jpg`
- 6.Record a clip: `camsnap clip kitchen --dur 5s --out clip.mp4`
- 7.Monitor for motion: `camsnap watch kitchen --threshold 0.2 --action '...'`
Use cases
- Automated security monitoring that triggers on motion detection
- Capturing time-lapse or event-based clips for review
- Integrating camera feeds into CI/CD or automation pipelines
- Discovering and diagnosing camera connectivity issues
- Building custom surveillance workflows with motion-triggered actions
- DevOps engineers building camera automation
- Security system integrators
- Home automation enthusiasts
- Developers creating surveillance applications
camsnap FAQ
camsnap supports RTSP and ONVIF-compatible IP cameras.
Yes, ffmpeg must be installed and available on your PATH for camsnap to work.
Use `camsnap add --name <name> --host <ip> --user <user> --pass <pass>` to configure a camera.
Yes, use `camsnap doctor --probe` to diagnose camera connectivity issues.
Perform a short test capture first to verify the camera is working correctly.
Full instructions (SKILL.md)
Source of truth, from steipete/clawdis.
name: camsnap description: "Capture frames or clips from RTSP/ONVIF cameras." homepage: https://camsnap.ai metadata: { "openclaw": { "emoji": "📸", "requires": { "bins": ["camsnap"] }, "install": [ { "id": "brew", "kind": "brew", "formula": "steipete/tap/camsnap", "bins": ["camsnap"], "label": "Install camsnap (brew)", }, ], }, }
camsnap
Use camsnap to grab snapshots, clips, or motion events from configured cameras.
Setup
- Config file:
~/.config/camsnap/config.yaml - Add camera:
camsnap add --name kitchen --host 192.168.0.10 --user user --pass pass
Common commands
- Discover:
camsnap discover --info - Snapshot:
camsnap snap kitchen --out shot.jpg - Clip:
camsnap clip kitchen --dur 5s --out clip.mp4 - Motion watch:
camsnap watch kitchen --threshold 0.2 --action '...' - Doctor:
camsnap doctor --probe
Notes
- Requires
ffmpegon PATH. - Prefer a short test capture before longer clips.
Related skills
More from steipete/clawdis and the wider catalog.
