Clarify decoding and the detect role (#13580)

This commit is contained in:
Josh Hawkins 2024-09-05 20:59:47 -05:00 committed by GitHub
parent 55e1f865d8
commit a82c1f303b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 17 additions and 2 deletions

View File

@ -46,6 +46,14 @@ cameras:
side: ... side: ...
``` ```
:::note
If you only define one stream in your `inputs` and do not assign a `detect` role to it, Frigate will automatically assign it the `detect` role. Frigate will always decode a stream to support motion detection, Birdseye, the API image endpoints, and other features, even if you have disabled object detection with `enabled: False` in your config's `detect` section.
If you plan to use Frigate for recording only, it is still recommended to define a `detect` role for a low resolution stream to minimize resource usage from the required stream decoding.
:::
For camera model specific settings check the [camera specific](camera_specific.md) infos. For camera model specific settings check the [camera specific](camera_specific.md) infos.
## Setting up camera PTZ controls ## Setting up camera PTZ controls
@ -80,7 +88,7 @@ This list of working and non-working PTZ cameras is based on user feedback.
| Brand or specific camera | PTZ Controls | Autotracking | Notes | | Brand or specific camera | PTZ Controls | Autotracking | Notes |
| ------------------------ | :----------: | :----------: | ----------------------------------------------------------------------------------------------------------------------------------------------- | | ------------------------ | :----------: | :----------: | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| Amcrest | ✅ | ✅ | ⛔️ Generally, Amcrest should work, but some older models (like the common IP2M-841) don't support autotracking | | Amcrest | ✅ | ✅ | ⛔️ Generally, Amcrest should work, but some older models (like the common IP2M-841) don't support autotracking |
| Amcrest ASH21 | ✅ | ❌ | ONVIF service port: 80 | | Amcrest ASH21 | ✅ | ❌ | ONVIF service port: 80 |
| Ctronics PTZ | ✅ | ❌ | | | Ctronics PTZ | ✅ | ❌ | |
| Dahua | ✅ | ✅ | | | Dahua | ✅ | ✅ | |
| Dahua DH-SD2A500HB | ✅ | ❌ | | | Dahua DH-SD2A500HB | ✅ | ❌ | |

View File

@ -294,6 +294,14 @@ cameras:
If you don't have separate streams for detect and record, you would just add the record role to the list on the first input. If you don't have separate streams for detect and record, you would just add the record role to the list on the first input.
:::note
If you only define one stream in your `inputs` and do not assign a `detect` role to it, Frigate will automatically assign it the `detect` role. Frigate will always decode a stream to support motion detection, Birdseye, the API image endpoints, and other features, even if you have disabled object detection with `enabled: False` in your config's `detect` section.
If you plan to use Frigate for recording only, it is still recommended to define a `detect` role for a low resolution stream to minimize resource usage from the required stream decoding.
:::
By default, Frigate will retain video of all events for 10 days. The full set of options for recording can be found [here](../configuration/reference.md). By default, Frigate will retain video of all events for 10 days. The full set of options for recording can be found [here](../configuration/reference.md).
### Step 7: Complete config ### Step 7: Complete config
@ -309,4 +317,3 @@ Now that you have a working install, you can use the following documentation for
3. [Review](../configuration/review.md) 3. [Review](../configuration/review.md)
4. [Masks](../configuration/masks.md) 4. [Masks](../configuration/masks.md)
5. [Home Assistant Integration](../integrations/home-assistant.md) - Integrate with Home Assistant 5. [Home Assistant Integration](../integrations/home-assistant.md) - Integrate with Home Assistant