diff --git a/docs/docs/configuration/reference.md b/docs/docs/configuration/advanced/reference.md similarity index 100% rename from docs/docs/configuration/reference.md rename to docs/docs/configuration/advanced/reference.md diff --git a/docs/docs/configuration/advanced.md b/docs/docs/configuration/advanced/system.md similarity index 98% rename from docs/docs/configuration/advanced.md rename to docs/docs/configuration/advanced/system.md index 6ae023edac..7956fda46f 100644 --- a/docs/docs/configuration/advanced.md +++ b/docs/docs/configuration/advanced/system.md @@ -1,7 +1,6 @@ --- -id: advanced -title: Advanced Options -sidebar_label: Advanced Options +id: system +title: System --- import ConfigTabs from "@site/src/components/ConfigTabs"; @@ -202,7 +201,7 @@ model: :::warning -If the labelmap is customized then the labels used for alerts will need to be adjusted as well. See [alert labels](../configuration/review.md#restricting-alerts-to-specific-labels) for more info. +If the labelmap is customized then the labels used for alerts will need to be adjusted as well. See [alert labels](../review.md#restricting-alerts-to-specific-labels) for more info. ::: diff --git a/docs/docs/configuration/autotracking.md b/docs/docs/configuration/autotracking.md index 27312eaa92..7d0f8359d4 100644 --- a/docs/docs/configuration/autotracking.md +++ b/docs/docs/configuration/autotracking.md @@ -167,7 +167,7 @@ A fast [detector](object_detectors.md) is recommended. CPU detectors will not pe A full-frame zone in `required_zones` is not recommended, especially if you've calibrated your camera and there are `movement_weights` defined in the configuration file. Frigate will continue to autotrack an object that has entered one of the `required_zones`, even if it moves outside of that zone. -Some users have found it helpful to adjust the zone `inertia` value. See the [configuration reference](index.md). +Some users have found it helpful to adjust the zone `inertia` value. See the [configuration reference](advanced/reference.md). ## Zooming diff --git a/docs/docs/configuration/index.md b/docs/docs/configuration/config.md similarity index 99% rename from docs/docs/configuration/index.md rename to docs/docs/configuration/config.md index 00a35a74ab..c7e15be53a 100644 --- a/docs/docs/configuration/index.md +++ b/docs/docs/configuration/config.md @@ -1,5 +1,5 @@ --- -id: index +id: config title: Frigate Configuration --- diff --git a/docs/docs/configuration/live.md b/docs/docs/configuration/live.md index effe89de3c..e7ba6d6cbd 100644 --- a/docs/docs/configuration/live.md +++ b/docs/docs/configuration/live.md @@ -11,7 +11,7 @@ Frigate intelligently displays your camera streams on the Live view dashboard. B ### Live View technologies -Frigate intelligently uses three different streaming technologies to display your camera streams on the dashboard and the single camera view, switching between available modes based on network bandwidth, player errors, or required features like two-way talk. The highest quality and fluency of the Live view requires the bundled `go2rtc` to be [configured](/configuration/go2rtc). +Frigate intelligently uses three different streaming technologies to display your camera streams on the dashboard and the single camera view, switching between available modes based on network bandwidth, player errors, or required features like two-way talk. The highest quality and fluency of the Live view requires the bundled `go2rtc` to be configured as shown in the [step by step guide](/configuration/advanced/go2rtc). The jsmpeg live view will use more browser and client GPU resources. Using go2rtc is highly recommended and will provide a superior experience. diff --git a/docs/docs/frigate/installation.md b/docs/docs/frigate/installation.md index 0cec2819f9..1ddbdf7647 100644 --- a/docs/docs/frigate/installation.md +++ b/docs/docs/frigate/installation.md @@ -600,7 +600,7 @@ There are several variants of the App available: If you are using hardware acceleration for ffmpeg, you **may** need to use the _Full Access_ variant of the App. This is because the Frigate App runs in a container with limited access to the host system. The _Full Access_ variant allows you to disable _Protection mode_ and give Frigate full access to the host system. -You can also edit the Frigate configuration file through the [VS Code App](https://github.com/hassio-addons/addon-vscode) or similar. In that case, the configuration file will be at `/addon_configs//config.yml`, where `` is specific to the variant of the Frigate App you are running. See the list of directories [here](../configuration/index.md#accessing-app-config-dir). +You can also edit the Frigate configuration file through the [VS Code App](https://github.com/hassio-addons/addon-vscode) or similar. In that case, the configuration file will be at `/addon_configs//config.yml`, where `` is specific to the variant of the Frigate App you are running. See the list of directories [here](../configuration/advanced/config.md#accessing-app-config-dir). ## Kubernetes diff --git a/docs/docs/guides/getting_started.md b/docs/docs/guides/getting_started.md index 76b3e75d54..82546e8c9d 100644 --- a/docs/docs/guides/getting_started.md +++ b/docs/docs/guides/getting_started.md @@ -301,7 +301,7 @@ cameras: More details on available detectors can be found [here](../configuration/object_detectors.md). -Restart Frigate and you should start seeing detections for `person`. If you want to track other objects, they can be configured in or via the [configuration file reference](../configuration/reference.md). +Restart Frigate and you should start seeing detections for `person`. If you want to track other objects, they can be configured in or via the [configuration file reference](../configuration/advanced/reference.md). ### Step 5: Setup motion masks @@ -388,14 +388,14 @@ If you only plan to use Frigate for recording, it is still recommended to define ::: -By default, Frigate will retain video of all tracked objects 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 tracked objects for 10 days. The full set of options for recording can be found [here](../configuration/advanced/reference.md). ### Step 7: Complete config At this point you have a complete config with basic functionality. -- View [common configuration examples](../configuration/index.md#common-configuration-examples) for a list of common configuration examples. -- View [full config reference](../configuration/reference.md) for a complete list of configuration options. +- View [common configuration examples](../configuration/advanced/config.md#common-configuration-examples) for a list of common configuration examples. +- View [full config reference](../configuration/advanced/reference.md) for a complete list of configuration options. ### Follow up diff --git a/docs/docs/troubleshooting/cpu.md b/docs/docs/troubleshooting/cpu.md index a9f449ad88..18ae8b7013 100644 --- a/docs/docs/troubleshooting/cpu.md +++ b/docs/docs/troubleshooting/cpu.md @@ -24,7 +24,7 @@ Video decoding is one of the most CPU-intensive tasks in Frigate. While an AI ac ### Configuration -Frigate provides preset configurations for common hardware acceleration scenarios. Set up `hwaccel_args` based on your hardware in your [configuration](../configuration/reference) as described in the [getting started guide](../guides/getting_started). +Frigate provides preset configurations for common hardware acceleration scenarios. Set up `hwaccel_args` based on your hardware in your [configuration](../configuration/advanced/reference) as described in the [getting started guide](../guides/getting_started). ### Troubleshooting Hardware Acceleration diff --git a/docs/docs/troubleshooting/go2rtc.md b/docs/docs/troubleshooting/go2rtc.md index 4a9a151aad..0d55ccfe69 100644 --- a/docs/docs/troubleshooting/go2rtc.md +++ b/docs/docs/troubleshooting/go2rtc.md @@ -7,7 +7,7 @@ import ConfigTabs from "@site/src/components/ConfigTabs"; import TabItem from "@theme/TabItem"; import NavPath from "@site/src/components/NavPath"; -This page covers common problems with the bundled [go2rtc](/configuration/go2rtc) and how to resolve them, whether your cameras were added with the setup wizard or configured by hand. +This page covers common problems with the bundled [go2rtc](/configuration/advanced/go2rtc) and how to resolve them, whether your cameras were added with the setup wizard or configured by hand. When a stream won't play or behaves oddly, the most important first step is to figure out **where** in the pipeline it breaks. Frigate's live view is a chain — _camera → go2rtc → your browser_ — and each stage fails for different reasons. Work through the checks below in order, then jump to the matching problem category. diff --git a/docs/sidebars.ts b/docs/sidebars.ts index f319f08f21..ce1a110e74 100644 --- a/docs/sidebars.ts +++ b/docs/sidebars.ts @@ -21,88 +21,116 @@ const sidebars: SidebarsConfig = { "guides/ha_network_storage", "guides/reverse_proxy", ], - Configuration: { - "Configuration Files": [ - "configuration/index", - "configuration/reference", - { - type: "link", - label: "Go2RTC Configuration Reference", - href: "https://github.com/AlexxIT/go2rtc/tree/v1.9.13#configuration", - } as PropSidebarItemLink, - ], - Detectors: [ - "configuration/object_detectors", - "configuration/audio_detectors", - ], - Enrichments: [ - "configuration/semantic_search", - "configuration/face_recognition", - "configuration/license_plate_recognition", - "configuration/bird_classification", - { - type: "category", - label: "Custom Classification", - link: { - type: "generated-index", - title: "Custom Classification", - description: "Configuration for custom classification models", + Configuration: [ + "configuration/config", + { + type: "category", + label: "Detectors", + items: [ + "configuration/object_detectors", + "configuration/audio_detectors", + ], + }, + { + type: "category", + label: "Enrichments", + items: [ + "configuration/semantic_search", + "configuration/face_recognition", + "configuration/license_plate_recognition", + "configuration/bird_classification", + { + type: "category", + label: "Custom Classification", + link: { + type: "generated-index", + title: "Custom Classification", + description: "Configuration for custom classification models", + }, + items: [ + "configuration/custom_classification/state_classification", + "configuration/custom_classification/object_classification", + ], }, - items: [ - "configuration/custom_classification/state_classification", - "configuration/custom_classification/object_classification", - ], - }, - { - type: "category", - label: "Generative AI", - link: { - type: "generated-index", - title: "Generative AI", - description: "Generative AI Features", + { + type: "category", + label: "Generative AI", + link: { + type: "generated-index", + title: "Generative AI", + description: "Generative AI Features", + }, + items: [ + "configuration/genai/genai_config", + "configuration/genai/genai_review", + "configuration/genai/genai_objects", + ], }, - items: [ - "configuration/genai/genai_config", - "configuration/genai/genai_review", - "configuration/genai/genai_objects", - ], - }, - ], - Cameras: [ - "configuration/cameras", - "configuration/review", - "configuration/record", - "configuration/exports", - "configuration/snapshots", - "configuration/motion_detection", - "configuration/birdseye", - "configuration/live", - "configuration/restream", - "configuration/autotracking", - "configuration/camera_specific", - ], - Objects: [ - "configuration/object_filters", - "configuration/masks", - "configuration/zones", - "configuration/objects", - "configuration/stationary_objects", - ], - "Hardware Acceleration": [ - "configuration/hardware_acceleration_video", - "configuration/hardware_acceleration_enrichments", - ], - "Extra Configuration": [ - "configuration/authentication", - "configuration/notifications", - "configuration/profiles", - "configuration/go2rtc", - "configuration/ffmpeg_presets", - "configuration/pwa", - "configuration/tls", - "configuration/advanced", - ], - }, + ], + }, + { + type: "category", + label: "Cameras", + items: [ + "configuration/cameras", + "configuration/review", + "configuration/record", + "configuration/exports", + "configuration/snapshots", + "configuration/motion_detection", + "configuration/birdseye", + "configuration/live", + "configuration/restream", + "configuration/autotracking", + "configuration/camera_specific", + ], + }, + { + type: "category", + label: "Objects", + items: [ + "configuration/object_filters", + "configuration/masks", + "configuration/zones", + "configuration/objects", + "configuration/stationary_objects", + ], + }, + { + type: "category", + label: "Hardware Acceleration", + items: [ + "configuration/hardware_acceleration_video", + "configuration/hardware_acceleration_enrichments", + ], + }, + { + type: "category", + label: "Extra Configuration", + items: [ + "configuration/authentication", + "configuration/notifications", + "configuration/profiles", + "configuration/go2rtc", + "configuration/ffmpeg_presets", + "configuration/pwa", + "configuration/tls", + ], + }, + { + type: "category", + label: "Advanced Configuration", + items: [ + "configuration/advanced/system", + "configuration/advanced/reference", + { + type: "link", + label: "Go2RTC Configuration Reference", + href: "https://github.com/AlexxIT/go2rtc/tree/v1.9.13#configuration", + } as PropSidebarItemLink, + ], + }, + ], Integrations: [ "integrations/plus", "integrations/home-assistant",