camsnap

Capture snapshots or clips from RTSP/ONVIF cameras via command interfaces.

386k|81.1k|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/steipete/clawdis --skill camsnap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: camsnap
Source: https://github.com/steipete/clawdis/tree/main/skills/camsnap
Command: npx skills add https://github.com/steipete/clawdis --skill camsnap

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill lets you capture snapshots or short clips from configured RTSP/ONVIF cameras, enabling quick visual verification, monitoring, and motion-based recording.

Core Features & Use Cases

  • Snapshot capture: Grab a single frame from a camera.
  • Video clips: Record short clips on demand or triggered by motion events.
  • Motion watch: Monitor a camera and trigger actions based on motion thresholds.
  • Operator health checks: Run 'doctor' to probe camera reachability and configuration.

Quick Start

Add a camera and capture a snapshot: camsnap add --name kitchen --host 192.168.0.10 --user user --pass pass camsnap snap kitchen --out shot.jpg Discover cameras: camsnap discover --info Create a clip: camsnap clip kitchen --dur 5s --out clip.mp4 Monitor: camsnap watch kitchen --threshold 0.2 --action 'notify'

Frequently Asked Questions about camsnap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I capture snapshots from RTSP or ONVIF cameras?

Snapshots capture single frames directly from RTSP or ONVIF camera streams. Configure your camera in ~/.config/camsnap/config.yaml, then use `camsnap snap [camera-name] --out shot.jpg` to grab a frame and save it as an image file.

Can I record video clips from a camera feed on demand?

Yes, record clips on demand by running `camsnap clip [camera-name] --dur 5s --out clip.mp4`. FFmpeg processes the RTSP stream and writes the specified duration to an MP4 file at your chosen path.

What do I need to set up before using camsnap?

You need FFmpeg installed on your PATH, a local configuration file at ~/.config/camsnap/config.yaml with camera credentials and network details, and network access to your RTSP or ONVIF cameras. Run `camsnap doctor` to verify connectivity.

How does motion detection and triggering work with camsnap?

The `camsnap watch` command monitors a camera stream and triggers actions when motion exceeds a threshold you set. Use `--threshold 0.2 --action 'notify'` to define sensitivity and specify what happens when motion is detected.

Can camsnap discover cameras on my network automatically?

Yes, run `camsnap discover --info` to scan your network and list available RTSP and ONVIF cameras with their connection details, making it easier to add them to your configuration.

What's the difference between RTSP and ONVIF camera support?

RTSP is a streaming protocol for video transport; ONVIF is a standardized interface for camera discovery and control. Camsnap supports both protocols, letting you work with most IP cameras and network video recorders.