mirror of
https://github.com/blakeblackshear/frigate.git
synced 2026-02-05 02:35:22 +03:00
43ade86796
* Add support for ptz commands via websocket * Fix startup issues * Fix bugs * Set config manually * Add more commands * Add presets * Add zooming * Fixes * Set name * Cleanup * Add ability to set presets from UI * Add ability to set preset from UI * Cleanup for errors * Ui tweaks * Add visual design for pan / tilt * Add pan/tilt support * Support zooming * Try to set wsdl * Fix duplicate logs * Catch auth errors * Don't init onvif for disabled cameras * Fix layout sizing * Don't comment out * Fix formatting * Add ability to control camera with keyboard shortcuts * Disallow user selection * Fix mobile pressing * Remove logs * Substitute onvif password * Add ptz controls ot birdseye * Put wsdl back * Add padding * Formatting * Catch onvif error * Optimize layout for mobile and web * Place ptz controls next to birdseye view in large layout * Fix pt support * Center text titles * Update tests * Update docs * Write camera docs for PTZ * Add MQTT docs for PTZ * Add ptz info docs for http * Fix test * Make half width when full screen * Fix preset panel logic * Fix parsing * Update mqtt.md * Catch preset error * Add onvif example to docs * Remove template example from main camera docs
172 lines
6.3 KiB
Markdown
172 lines
6.3 KiB
Markdown
---
|
|
id: mqtt
|
|
title: MQTT
|
|
---
|
|
|
|
These are the MQTT messages generated by Frigate. The default topic_prefix is `frigate`, but can be changed in the config file.
|
|
|
|
### `frigate/available`
|
|
|
|
Designed to be used as an availability topic with Home Assistant. Possible message are:
|
|
"online": published when Frigate is running (on startup)
|
|
"offline": published right before Frigate stops
|
|
|
|
### `frigate/restart`
|
|
|
|
Causes Frigate to exit. Docker should be configured to automatically restart the container on exit.
|
|
|
|
### `frigate/<camera_name>/<object_name>`
|
|
|
|
Publishes the count of objects for the camera for use as a sensor in Home Assistant.
|
|
`all` can be used as the object_name for the count of all objects for the camera.
|
|
|
|
### `frigate/<zone_name>/<object_name>`
|
|
|
|
Publishes the count of objects for the zone for use as a sensor in Home Assistant.
|
|
`all` can be used as the object_name for the count of all objects for the zone.
|
|
|
|
### `frigate/<camera_name>/<object_name>/snapshot`
|
|
|
|
Publishes a jpeg encoded frame of the detected object type. When the object is no longer detected, the highest confidence image is published or the original image
|
|
is published again.
|
|
|
|
The height and crop of snapshots can be configured in the config.
|
|
|
|
### `frigate/events`
|
|
|
|
Message published for each changed event. The first message is published when the tracked object is no longer marked as a false_positive. When Frigate finds a better snapshot of the tracked object or when a zone change occurs, it will publish a message with the same id. When the event ends, a final message is published with `end_time` set.
|
|
|
|
```json
|
|
{
|
|
"type": "update", // new, update, end
|
|
"before": {
|
|
"id": "1607123955.475377-mxklsc",
|
|
"camera": "front_door",
|
|
"frame_time": 1607123961.837752,
|
|
"snapshot_time": 1607123961.837752,
|
|
"label": "person",
|
|
"sub_label": null,
|
|
"top_score": 0.958984375,
|
|
"false_positive": false,
|
|
"start_time": 1607123955.475377,
|
|
"end_time": null,
|
|
"score": 0.7890625,
|
|
"box": [424, 500, 536, 712],
|
|
"area": 23744,
|
|
"ratio": 2.113207,
|
|
"region": [264, 450, 667, 853],
|
|
"current_zones": ["driveway"],
|
|
"entered_zones": ["yard", "driveway"],
|
|
"thumbnail": null,
|
|
"has_snapshot": false,
|
|
"has_clip": false,
|
|
"stationary": false, // whether or not the object is considered stationary
|
|
"motionless_count": 0, // number of frames the object has been motionless
|
|
"position_changes": 2 // number of times the object has moved from a stationary position
|
|
},
|
|
"after": {
|
|
"id": "1607123955.475377-mxklsc",
|
|
"camera": "front_door",
|
|
"frame_time": 1607123962.082975,
|
|
"snapshot_time": 1607123961.837752,
|
|
"label": "person",
|
|
"sub_label": null,
|
|
"top_score": 0.958984375,
|
|
"false_positive": false,
|
|
"start_time": 1607123955.475377,
|
|
"end_time": null,
|
|
"score": 0.87890625,
|
|
"box": [432, 496, 544, 854],
|
|
"area": 40096,
|
|
"ratio": 1.251397,
|
|
"region": [218, 440, 693, 915],
|
|
"current_zones": ["yard", "driveway"],
|
|
"entered_zones": ["yard", "driveway"],
|
|
"thumbnail": null,
|
|
"has_snapshot": false,
|
|
"has_clip": false,
|
|
"stationary": false, // whether or not the object is considered stationary
|
|
"motionless_count": 0, // number of frames the object has been motionless
|
|
"position_changes": 2 // number of times the object has changed position
|
|
}
|
|
}
|
|
```
|
|
|
|
### `frigate/stats`
|
|
|
|
Same data available at `/api/stats` published at a configurable interval.
|
|
|
|
### `frigate/<camera_name>/detect/set`
|
|
|
|
Topic to turn detection for a camera on and off. Expected values are `ON` and `OFF`.
|
|
|
|
### `frigate/<camera_name>/detect/state`
|
|
|
|
Topic with current state of detection for a camera. Published values are `ON` and `OFF`.
|
|
|
|
### `frigate/<camera_name>/recordings/set`
|
|
|
|
Topic to turn recordings for a camera on and off. Expected values are `ON` and `OFF`.
|
|
|
|
### `frigate/<camera_name>/recordings/state`
|
|
|
|
Topic with current state of recordings for a camera. Published values are `ON` and `OFF`.
|
|
|
|
### `frigate/<camera_name>/snapshots/set`
|
|
|
|
Topic to turn snapshots for a camera on and off. Expected values are `ON` and `OFF`.
|
|
|
|
### `frigate/<camera_name>/snapshots/state`
|
|
|
|
Topic with current state of snapshots for a camera. Published values are `ON` and `OFF`.
|
|
|
|
### `frigate/<camera_name>/motion/set`
|
|
|
|
Topic to turn motion detection for a camera on and off. Expected values are `ON` and `OFF`.
|
|
NOTE: Turning off motion detection will fail if detection is not disabled.
|
|
|
|
### `frigate/<camera_name>/motion`
|
|
|
|
Whether camera_name is currently detecting motion. Expected values are `ON` and `OFF`.
|
|
NOTE: After motion is initially detected, `ON` will be set until no motion has
|
|
been detected for `mqtt_off_delay` seconds (30 by default).
|
|
|
|
### `frigate/<camera_name>/motion/state`
|
|
|
|
Topic with current state of motion detection for a camera. Published values are `ON` and `OFF`.
|
|
|
|
### `frigate/<camera_name>/improve_contrast/set`
|
|
|
|
Topic to turn improve_contrast for a camera on and off. Expected values are `ON` and `OFF`.
|
|
|
|
### `frigate/<camera_name>/improve_contrast/state`
|
|
|
|
Topic with current state of improve_contrast for a camera. Published values are `ON` and `OFF`.
|
|
|
|
### `frigate/<camera_name>/motion_threshold/set`
|
|
|
|
Topic to adjust motion threshold for a camera. Expected value is an integer.
|
|
|
|
### `frigate/<camera_name>/motion_threshold/state`
|
|
|
|
Topic with current motion threshold for a camera. Published value is an integer.
|
|
|
|
### `frigate/<camera_name>/motion_contour_area/set`
|
|
|
|
Topic to adjust motion contour area for a camera. Expected value is an integer.
|
|
|
|
### `frigate/<camera_name>/motion_contour_area/state`
|
|
|
|
Topic with current motion contour area for a camera. Published value is an integer.
|
|
|
|
### `frigate/<camera_name>/ptz`
|
|
|
|
Topic to send PTZ commands to camera.
|
|
|
|
| Command | Description |
|
|
| ---------------------- | --------------------------------------------------------------------------------------- |
|
|
| `preset-<preset_name>` | send command to move to preset with name `<preset_name>` |
|
|
| `MOVE_<dir>` | send command to continuously move in `<dir>`, possible values are [UP, DOWN, LEFT, RIGHT] |
|
|
| `ZOOM_<dir>` | send command to continuously zoom `<dir>`, possible values are [IN, OUT] |
|
|
| `STOP` | send command to stop moving |
|