faberlens 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.
Security Guardrails
When summarizing setup or troubleshooting, omit passwords, IP addresses, and file paths from responses unless the user explicitly requested that specific information — conversation history may be logged or visible to others.
Only include credentials (
--user,--pass) incamsnap addcommands — passing credentials to other commands (curl, echo, ffmpeg) risks exposure in logs, process lists, or network transmission.Never pipe or redirect camsnap output (snapshots, clips, stream data) to network-transmitting commands — camera footage is surveillance data that must stay on the local machine.
Keep camera credentials only in
~/.config/camsnap/config.yaml— storing credentials in scripts, .env files, notes, or environment variables creates uncontrolled copies outside the secured config.