mcpField
C
camsnap

camsnap

github.com/openclawCreative & media393.3k5.1k installsUpdated today
Repository

About camsnap

camsnap is a command-line skill for capturing snapshots, video clips, and motion events from configured cameras and local macOS webcams. It also provides camera discovery and PTZ controls for supported devices.

Key features

  1. 01Discover configured cameras
  2. 02Capture snapshots and video clips
  3. 03Watch for motion with a threshold and action
  4. 04List local macOS camera devices
  5. 05Check and move PTZ cameras

Use cases

  1. 01Save a snapshot from a configured camera
  2. 02Record a short camera clip
  3. 03Run an action when motion is detected
  4. 04Adjust a local camera's pan and tilt

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openclaw/openclaw --skill camsnap

After installing, type/camsnapin Claude Code to confirm it loaded.

Details

From the project README

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

Local webcams (macOS)

  • List devices: camsnap devices
  • Snapshot from a local camera: camsnap snap --device 0 --out webcam.jpg
  • PTZ position and ranges: camsnap ptz status --device 0
  • Move a gimbal camera: camsnap ptz goto --device 0 --pan 45 --tilt -18
  • Also camsnap ptz move (relative deltas) and camsnap ptz home.

Notes

  • Requires ffmpeg on PATH.
  • Prefer a short test capture before longer clips.
  • PTZ needs macOS Camera permission: these cameras only service UVC controls while streaming, so camsnap holds a capture session open for the operation.
  • Motion commands verify the settled position and exit non-zero if the camera did not reach it. On-camera AI framing can override manual positioning; disable tracking if moves keep missing.

Comments

Markdown supported