mirror of
https://github.com/blakeblackshear/frigate.git
synced 2026-06-21 11:51:53 +03:00
tweaks
This commit is contained in:
parent
cf9b36c5f5
commit
7beceab71e
@ -259,11 +259,11 @@ cameras:
|
|||||||
|
|
||||||
### Camera state
|
### Camera state
|
||||||
|
|
||||||
Each camera has three possible states, surfaced as a status selector in **Settings → Camera Management**:
|
Each camera has three possible states, surfaced as a status selector in **Settings → Global configuration → Camera management**:
|
||||||
|
|
||||||
- **On** — streams are processed normally. Object detection, recording, and Live view are active.
|
- **On** — streams are processed normally. Object detection, recording, and Live view are active.
|
||||||
- **Off** — Frigate's ffmpeg processes are paused. Recording stops, object detection is paused, and the Live dashboard displays a blank image with a "Camera is off" message. The camera is still visible in the Live dashboard and its past review items, tracked objects, and historical footage remain accessible via the UI. This state does **not** persist across Frigate restarts; the camera returns to On after a restart.
|
- **Off** — Frigate's ffmpeg processes are paused. Recording stops, object detection is paused, and the Live dashboard displays a blank image with a "Camera is off" message. The camera is still visible in the Live dashboard and its past review items, tracked objects, and historical footage remain accessible via the UI. This state does **not** persist across Frigate restarts; the camera returns to On after a restart.
|
||||||
- **Disabled** — the change is saved to your configuration file (`enabled: False`). The camera stops immediately, Frigate stops ffmpeg processes, and all live and historical UI elements for the camera are no longer visible but remains retained on disk. The camera is still listed in **Settings → Camera Management** so it can be re-enabled. **A restart of Frigate is required to bring a disabled camera back to On.**
|
- **Disabled** — the change is saved to your configuration file (`enabled: False`). The camera stops immediately, Frigate stops ffmpeg processes, and all live and historical UI elements for the camera are no longer visible but remains retained on disk. The camera is still listed in **Settings → Global configuration → Camera management** so it can be re-enabled. **A restart of Frigate is required to bring a disabled camera back to On.**
|
||||||
|
|
||||||
#### Turning a camera on or off
|
#### Turning a camera on or off
|
||||||
|
|
||||||
@ -271,14 +271,14 @@ Turning a camera off is temporary and does not require a restart. The available
|
|||||||
|
|
||||||
- The power button in the single-camera Live view header
|
- The power button in the single-camera Live view header
|
||||||
- The right-click context menu on a camera tile on the Live dashboard
|
- The right-click context menu on a camera tile on the Live dashboard
|
||||||
- The Camera Management settings pane (status set to **Off**)
|
- The Camera management settings pane (status set to **Off**)
|
||||||
- The mobile settings drawer on the single-camera Live view (admin users only)
|
- The mobile settings drawer on the single-camera Live view (admin users only)
|
||||||
- The [MQTT topic](/integrations/mqtt#frigatecamera_nameenabledset) `frigate/<camera_name>/enabled/set` with payload `ON` or `OFF`
|
- The [MQTT topic](/integrations/mqtt#frigatecamera_nameenabledset) `frigate/<camera_name>/enabled/set` with payload `ON` or `OFF`
|
||||||
- The Home Assistant integration via the [`camera.turn_on` / `camera.turn_off` actions](/integrations/home-assistant#camera-api)
|
- The Home Assistant integration via the [`camera.turn_on` / `camera.turn_off` actions](/integrations/home-assistant#camera-api)
|
||||||
|
|
||||||
#### Disabling a camera
|
#### Disabling a camera
|
||||||
|
|
||||||
Disabling a camera saves the change to your configuration file. Navigate to **Settings → Camera Management** and set the camera's status to **Disabled**. Runtime processing stops immediately; the change persists across restarts.
|
Disabling a camera saves the change to your configuration file. Navigate to **Settings → Global configuration → Camera management** and set the camera's status to **Disabled**. Runtime processing stops immediately; the change persists across restarts.
|
||||||
|
|
||||||
Re-enabling a disabled camera requires a restart of Frigate so that the ffmpeg processes and other camera-scoped resources can be initialized. The UI will prompt you to restart when you switch a disabled camera back to On.
|
Re-enabling a disabled camera requires a restart of Frigate so that the ffmpeg processes and other camera-scoped resources can be initialized. The UI will prompt you to restart when you switch a disabled camera back to On.
|
||||||
|
|
||||||
@ -288,7 +288,7 @@ For both Off and Disabled cameras, go2rtc remains active but does not use system
|
|||||||
|
|
||||||
#### Choosing Off versus Disabled
|
#### Choosing Off versus Disabled
|
||||||
|
|
||||||
If you want a camera's historical data (review items, tracked objects, footage) to stay accessible in the UI while you stop processing, set the camera to **Off**. If you want the camera fully removed from the Live dashboard, review filters, and other UI surfaces, set it to **Disabled**. The Disabled state still keeps the camera in Camera Management so it can be re-enabled later; if you want to remove all traces of a camera including its configuration, delete it via Camera Management instead.
|
If you want a camera's historical data (review items, tracked objects, footage) to stay accessible in the UI while you stop processing, set the camera to **Off**. If you want the camera fully removed from the Live dashboard, review filters, and other UI surfaces, set it to **Disabled**. The Disabled state still keeps the camera in Camera management so it can be re-enabled later; if you want to remove all traces of a camera including its configuration, delete it via Camera management instead.
|
||||||
|
|
||||||
### Live player error messages
|
### Live player error messages
|
||||||
|
|
||||||
|
|||||||
@ -368,7 +368,7 @@ The published value is the detected state class name (e.g., `open`, `closed`, `o
|
|||||||
|
|
||||||
### `frigate/<camera_name>/enabled/set`
|
### `frigate/<camera_name>/enabled/set`
|
||||||
|
|
||||||
Topic to turn Frigate's processing of a camera on or off at runtime. Expected values are `ON` and `OFF`. The change is **not** persisted across Frigate restarts — the camera returns to the configured state on restart. To permanently disable a camera, use **Settings → Camera Management** in the Frigate UI. See [Camera state](/configuration/live#camera-state) for the difference between turning a camera off and disabling it.
|
Topic to turn Frigate's processing of a camera on or off at runtime. Expected values are `ON` and `OFF`. The change is **not** persisted across Frigate restarts — the camera returns to the configured state on restart. To permanently disable a camera, use **Settings → Global configuration → Camera management** in the Frigate UI. See [Camera state](/configuration/live#camera-state) for the difference between turning a camera off and disabling it.
|
||||||
|
|
||||||
### `frigate/<camera_name>/enabled/state`
|
### `frigate/<camera_name>/enabled/state`
|
||||||
|
|
||||||
|
|||||||
@ -475,7 +475,7 @@
|
|||||||
"selectCamera": "Select a Camera",
|
"selectCamera": "Select a Camera",
|
||||||
"backToSettings": "Back to Camera Settings",
|
"backToSettings": "Back to Camera Settings",
|
||||||
"streams": {
|
"streams": {
|
||||||
"title": "Camera State",
|
"title": "Camera State and Details",
|
||||||
"label": "Camera state",
|
"label": "Camera state",
|
||||||
"description": "Set the operating state for each camera.<br /><br /><strong>On</strong>: streams are processed normally.<br /><strong>Off</strong>: temporarily pauses processing. Does not persist across Frigate restarts.<br /><strong>Disabled</strong>: stops processing and saves the change to your configuration. A restart is required to re-enable a disabled camera.<br /><br /><em>Note: Disabling does not affect go2rtc restreams.</em><br /><br />Drag the handle to reorder active cameras as they appear throughout the UI, including the Live dashboard and camera selection dropdowns.",
|
"description": "Set the operating state for each camera.<br /><br /><strong>On</strong>: streams are processed normally.<br /><strong>Off</strong>: temporarily pauses processing. Does not persist across Frigate restarts.<br /><strong>Disabled</strong>: stops processing and saves the change to your configuration. A restart is required to re-enable a disabled camera.<br /><br /><em>Note: Disabling does not affect go2rtc restreams.</em><br /><br />Drag the handle to reorder active cameras as they appear throughout the UI, including the Live dashboard and camera selection dropdowns.",
|
||||||
"disabledSubheading": "Disabled in configuration",
|
"disabledSubheading": "Disabled in configuration",
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user