Full UI configuration (#22151)

* use react-jsonschema-form for UI config

* don't use properties wrapper when generating config i18n json

* configure for full i18n support

* section fields

* add descriptions to all fields for i18n

* motion i18n

* fix nullable fields

* sanitize internal fields

* add switches widgets and use friendly names

* fix nullable schema entries

* ensure update_topic is added to api calls

this needs further backend implementation to work correctly

* add global sections, camera config overrides, and reset button

* i18n

* add reset logic to global config view

* tweaks

* fix sections and live validation

* fix validation for schema objects that can be null

* generic and custom per-field validation

* improve generic error validation messages

* remove show advanced fields switch

* tweaks

* use shadcn theme

* fix array field template

* i18n tweaks

* remove collapsible around root section

* deep merge schema for advanced fields

* add array field item template and fix ffmpeg section

* add missing i18n keys

* tweaks

* comment out api call for testing

* add config groups as a separate i18n namespace

* add descriptions to all pydantic fields

* make titles more concise

* new titles as i18n

* update i18n config generation script to use json schema

* tweaks

* tweaks

* rebase

* clean up

* form tweaks

* add wildcards and fix object filter fields

* add field template for additionalproperties schema objects

* improve typing

* add section description from schema and clarify global vs camera level descriptions

* separate and consolidate global and camera i18n namespaces

* clean up now obsolete namespaces

* tweaks

* refactor sections and overrides

* add ability to render components before and after fields

* fix titles

* chore(sections): remove legacy single-section components replaced by template

* refactor configs to use individual files with a template

* fix review description

* apply hidden fields after ui schema

* move util

* remove unused i18n

* clean up error messages

* fix fast refresh

* add custom validation and use it for ffmpeg input roles

* update nav tree

* remove unused

* re-add override and modified indicators

* mark pending changes and add confirmation dialog for resets

* fix red unsaved dot

* tweaks

* add docs links, readonly keys, and restart required per field

* add special case and comments for global motion section

* add section form special cases

* combine review sections

* tweaks

* add audio labels endpoint

* add audio label switches and input to filter list

* fix type

* remove key from config when resetting to default/global

* don't show description for new key/val fields

* tweaks

* spacing tweaks

* add activity indicator and scrollbar tweaks

* add docs to filter fields

* wording changes

* fix global ffmpeg section

* add review classification zones to review form

* add backend endpoint and frontend widget for ffmpeg presets and manual args

* improve wording

* hide descriptions for additional properties arrays

* add warning log about incorrectly nested model config

* spacing and language tweaks

* fix i18n keys

* networking section docs and description

* small wording tweaks

* add layout grid field

* refactor with shared utilities

* field order

* add individual detectors to schema

add detector titles and descriptions (docstrings in pydantic are used for descriptions) and add i18n keys to globals

* clean up detectors section and i18n

* don't save model config back to yaml when saving detectors

* add full detectors config to api model dump

works around the way we use detector plugins so we can have the full detector config for the frontend

* add restart button to toast when restart is required

* add ui option to remove inner cards

* fix buttons

* section tweaks

* don't zoom into text on mobile

* make buttons sticky at bottom of sections

* small tweaks

* highlight label of changed fields

* add null to enum list when unwrapping

* refactor to shared utils and add save all button

* add undo all button

* add RJSF to dictionary

* consolidate utils

* preserve form data when changing cameras

* add mono fonts

* add popover to show what fields will be saved

* fix mobile menu not re-rendering with unsaved dots

* tweaks

* fix logger and env vars config section saving

use escaped periods in keys to retain them in the config file (eg "frigate.embeddings")

* add timezone widget

* role map field with validation

* fix validation for model section

* add another hidden field

* add footer message for required restart

* use rjsf for notifications view

* fix config saving

* add replace rules field

* default column layout and add field sizing

* clean up field template

* refactor profile settings to match rjsf forms

* tweaks

* refactor frigate+ view and make tweaks to sections

* show frigate+ model info in detection model settings when using a frigate+ model

* update restartRequired for all fields

* fix restart fields

* tweaks and add ability enable disabled cameras

more backend changes required

* require restart when enabling camera that is disabled in config

* disable save when form is invalid

* refactor ffmpeg section for readability

* change label

* clean up camera inputs fields

* misc tweaks to ffmpeg section

- add raw paths endpoint to ensure credentials get saved
- restart required tooltip

* maintenance settings tweaks

* don't mutate with lodash

* fix description re-rendering for nullable object fields

* hide reindex field

* update rjsf

* add frigate+ description to settings pane

* disable save all when any section is invalid

* show translated field name in validation error pane

* clean up

* remove unused

* fix genai merge

* fix genai

frigate/config/camera/onvif.py

@@ -17,37 +17,57 @@ class ZoomingModeEnum(str, Enum):
 
 
 class PtzAutotrackConfig(FrigateBaseModel):
-    enabled: bool = Field(default=False, title="Enable PTZ object autotracking.")
+    enabled: bool = Field(
+        default=False,
+        title="Enable Autotracking",
+        description="Enable or disable automatic PTZ camera tracking of detected objects.",
+    )
     calibrate_on_startup: bool = Field(
-        default=False, title="Perform a camera calibration when Frigate starts."
+        default=False,
+        title="Calibrate on start",
+        description="Measure PTZ motor speeds on startup to improve tracking accuracy. Frigate will update config with movement_weights after calibration.",
     )
     zooming: ZoomingModeEnum = Field(
-        default=ZoomingModeEnum.disabled, title="Autotracker zooming mode."
+        default=ZoomingModeEnum.disabled,
+        title="Zoom mode",
+        description="Control zoom behavior: disabled (pan/tilt only), absolute (most compatible), or relative (concurrent pan/tilt/zoom).",
     )
     zoom_factor: float = Field(
         default=0.3,
-        title="Zooming factor (0.1-0.75).",
+        title="Zoom factor",
+        description="Control zoom level on tracked objects. Lower values keep more scene in view; higher values zoom in closer but may lose tracking. Values between 0.1 and 0.75.",
         ge=0.1,
         le=0.75,
     )
-    track: list[str] = Field(default=DEFAULT_TRACKED_OBJECTS, title="Objects to track.")
+    track: list[str] = Field(
+        default=DEFAULT_TRACKED_OBJECTS,
+        title="Tracked objects",
+        description="List of object types that should trigger autotracking.",
+    )
     required_zones: list[str] = Field(
         default_factory=list,
-        title="List of required zones to be entered in order to begin autotracking.",
+        title="Required zones",
+        description="Objects must enter one of these zones before autotracking begins.",
     )
     return_preset: str = Field(
         default="home",
-        title="Name of camera preset to return to when object tracking is over.",
+        title="Return preset",
+        description="ONVIF preset name configured in camera firmware to return to after tracking ends.",
     )
     timeout: int = Field(
-        default=10, title="Seconds to delay before returning to preset."
+        default=10,
+        title="Return timeout",
+        description="Wait this many seconds after losing tracking before returning camera to preset position.",
     )
     movement_weights: Optional[Union[str, list[str]]] = Field(
         default_factory=list,
-        title="Internal value used for PTZ movements based on the speed of your camera's motor.",
+        title="Movement weights",
+        description="Calibration values automatically generated by camera calibration. Do not modify manually.",
     )
     enabled_in_config: Optional[bool] = Field(
-        default=None, title="Keep track of original state of autotracking."
+        default=None,
+        title="Original autotrack state",
+        description="Internal field to track whether autotracking was enabled in configuration.",
     )
 
     @field_validator("movement_weights", mode="before")
@@ -72,16 +92,38 @@ class PtzAutotrackConfig(FrigateBaseModel):
 
 
 class OnvifConfig(FrigateBaseModel):
-    host: str = Field(default="", title="Onvif Host")
-    port: int = Field(default=8000, title="Onvif Port")
-    user: Optional[EnvString] = Field(default=None, title="Onvif Username")
-    password: Optional[EnvString] = Field(default=None, title="Onvif Password")
-    tls_insecure: bool = Field(default=False, title="Onvif Disable TLS verification")
+    host: str = Field(
+        default="",
+        title="ONVIF host",
+        description="Host (and optional scheme) for the ONVIF service for this camera.",
+    )
+    port: int = Field(
+        default=8000,
+        title="ONVIF port",
+        description="Port number for the ONVIF service.",
+    )
+    user: Optional[EnvString] = Field(
+        default=None,
+        title="ONVIF username",
+        description="Username for ONVIF authentication; some devices require admin user for ONVIF.",
+    )
+    password: Optional[EnvString] = Field(
+        default=None,
+        title="ONVIF password",
+        description="Password for ONVIF authentication.",
+    )
+    tls_insecure: bool = Field(
+        default=False,
+        title="Disable TLS verify",
+        description="Skip TLS verification and disable digest auth for ONVIF (unsafe; use in safe networks only).",
+    )
     autotracking: PtzAutotrackConfig = Field(
         default_factory=PtzAutotrackConfig,
-        title="PTZ auto tracking config.",
+        title="Autotracking",
+        description="Automatically track moving objects and keep them centered in the frame using PTZ camera movements.",
     )
     ignore_time_mismatch: bool = Field(
         default=False,
-        title="Onvif Ignore Time Synchronization Mismatch Between Camera and Server",
+        title="Ignore time mismatch",
+        description="Ignore time synchronization differences between camera and Frigate server for ONVIF communication.",
     )