Назад към всички

Cameras

// Connect to security cameras, capture snapshots, and process video feeds with protocol support.

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameCameras
slugcameras
version1.0.1
descriptionConnect to security cameras, capture snapshots, and process video feeds with protocol support.
changelogUser-driven credential model, declared tool requirements
metadata[object Object]

Scope

This skill:

  • ✅ Generates camera capture commands
  • ✅ Guides integration with security systems
  • ✅ Provides troubleshooting for camera issues

User-driven model:

  • User provides camera credentials (RTSP URLs, passwords)
  • User runs capture commands
  • User installs required tools

This skill does NOT:

  • ❌ Store camera credentials
  • ❌ Run captures automatically without user request
  • ❌ Access cameras without user-provided access info

Requirements

Required:

  • ffmpeg — for capture and recording

Optional (user installs if needed):

  • gphoto2 — for DSLR/mirrorless control
  • v4l2-ctl — for USB cameras on Linux

Quick Reference

TopicFile
Security camera integrationsecurity-integration.md
USB/webcam capturecapture.md
DSLR controlphotography-control.md
Video processingprocessing.md

Core Rules

1. User Provides Camera Access

When user requests capture:

User: "Snapshot from my front door camera"
Agent: "I need the RTSP URL. Format: rtsp://user:pass@ip/stream
        Provide it or set CAMERA_FRONT_URL in env."
User: "rtsp://admin:pass@192.168.1.50/stream1"
→ Agent generates: ffmpeg -i "URL" -frames:v 1 snapshot.jpg

2. Common Commands

# Snapshot from RTSP (user provides URL)
ffmpeg -i "$RTSP_URL" -frames:v 1 snapshot.jpg

# Record 10s clip
ffmpeg -i "$RTSP_URL" -t 10 -c copy clip.mp4

# Webcam snapshot (macOS)
ffmpeg -f avfoundation -i "0" -frames:v 1 webcam.jpg

# Webcam snapshot (Linux)
ffmpeg -f v4l2 -i /dev/video0 -frames:v 1 webcam.jpg

3. Protocol Reference

ProtocolUse CaseURL Format
RTSPIP camerasrtsp://user:pass@ip:554/stream
HTTPSimple camshttp://ip/snapshot.jpg
V4L2USB cameras/dev/video0

4. Integration Patterns

With Home Assistant:

GET /api/camera_proxy/camera.front_door

User provides HA URL and token.

With Frigate:

  • MQTT: frigate/events for alerts
  • HTTP: /api/events/{id}/snapshot.jpg

5. Security

  • Never log camera URLs with credentials
  • Recommend user stores URLs in env vars
  • RTSP streams may be unencrypted — warn about LAN security