| name | unifi-protect |
| description | Manage UniFi Protect cameras, PTZ control, motion/smart events, NVR info, liveviews, lights, sensors, chimes, and viewers |
| triggers | ["show cameras","camera snapshot","ptz","unifi protect","motion events","camera events","liveview","protect cameras","camera stream","patrol"] |
| script | ../../src/unifi_protect_client.py |
UniFi Protect Skill
Interacts with the UniFi Protect API on a UniFi Dream Machine (UDM) to manage surveillance cameras and related devices.
Environment Setup
export UNIFI_API_KEY="your-api-key"
export UNIFI_HOST="10.220.1.1"
Safety: Dry-Run by Default
All write operations require --confirm to execute.
Commands
Cameras
python unifi_protect_client.py cameras list
python unifi_protect_client.py cameras get --id <camera_id>
python unifi_protect_client.py cameras snapshot --id <camera_id> --output /tmp/snap.jpg
python unifi_protect_client.py cameras stream-url --id <camera_id>
python unifi_protect_client.py cameras update --id <camera_id> --json '{"name":"Front Door"}' --confirm
PTZ Control
python unifi_protect_client.py ptz list-presets --id <camera_id>
python unifi_protect_client.py ptz goto-preset --id <camera_id> --preset-id 1 --confirm
python unifi_protect_client.py ptz patrol-start --id <camera_id> --confirm
python unifi_protect_client.py ptz patrol-stop --id <camera_id> --confirm
Events
python unifi_protect_client.py events list
python unifi_protect_client.py events list --type motion --limit 20
python unifi_protect_client.py events list --type smartDetectZone
python unifi_protect_client.py events get --id <event_id>
NVR
python unifi_protect_client.py nvr info
Liveviews
python unifi_protect_client.py liveviews list
python unifi_protect_client.py liveviews create --json '{"name":"Security","slots":[]}' --confirm
Lights, Sensors, Chimes, Viewers
python unifi_protect_client.py lights list
python unifi_protect_client.py lights update --id <id> --json '{"lightModeSettings":{"mode":"motion"}}' --confirm
python unifi_protect_client.py sensors list
python unifi_protect_client.py chimes list
python unifi_protect_client.py viewers list