add transcoded live streams and stream ordering for auto mode

Cameras can now add lower quality live streams that go2rtc transcodes to H.264 on demand. `live.transcode` takes a source stream and a list of heights and bitrates, and each quality becomes a `{camera}_transcode_{height}p` stream. The config validator adds them to `live.streams` without moving any the user already placed, and drops them when transcoding is disabled or a height changes. `create_config.py` writes them into go2rtc's generated config at startup, and saving the config or deleting a camera syncs them through go2rtc's API, so no restart is needed. They use `#hardware`, so go2rtc picks a hardware encoder and falls back to the CPU when there isn't one.

The Live playback settings stream list can be reordered by drag, since its order is the auto ladder. Auto order sorts it by bitrate, measuring native streams through a new admin-only `/go2rtc/streams/{name}/bitrate` endpoint and using the configured bitrate for transcoded ones. A pure reorder wasn't saved before because RJSF, the settings form, and `update_yaml` all ignore map key order. Sections can now mark a map with `orderedMaps`, which sends the whole map with `replace_paths` so `config_set` rewrites it in order.

Transcoded streams aren't in `go2rtc.streams`, which only lists yaml streams, so the frontend treated them as not restreamed and fell back to jsmpeg. Every restream check now goes through `isRestreamedStream`.

Auto treated any stall with no bytes in the last 2 seconds as a dead camera and handed it to the error fallback, which went straight to jsmpeg. Heavy congestion can stop delivery completely, so congested viewers skipped every lower stream. Auto now declines only when stats show the camera offline, and a stall on a live camera steps down. The stream picker also has a Try highest quality button that sends auto back to the top stream.

.github/workflows/pull_request.yml

@@ -124,7 +124,5 @@ jobs:
         run: devcontainer exec --workspace-folder . bash -lc "python3 -u -m mypy --config-file frigate/mypy.ini frigate"
       - name: Check API spec is up to date
         run: devcontainer exec --workspace-folder . bash -lc "python3 generate_api_auth_spec.py --check"
-      - name: Check analytics schema is up to date
-        run: devcontainer exec --workspace-folder . bash -lc "python3 generate_analytics_schema.py --check"
       - name: Run unit tests in devcontainer
         run: devcontainer exec --workspace-folder . bash -lc "python3 -u -m unittest"

docker/main/Dockerfile

@@ -381,7 +381,6 @@ FROM deps AS frigate
 
 WORKDIR /opt/frigate/
 COPY --from=rootfs / /
-ENV FRIGATE_IMAGE_VARIANT=standard
 
 # Pre-compile bytecode so a read-only rootfs doesn't force re-parsing the
 # source tree on every boot (pip-installed packages are already compiled)

docker/main/requirements-wheels.txt

@@ -27,7 +27,7 @@ pydantic == 2.10.*
 git+https://github.com/fbcotter/py3nvml#egg=py3nvml
 pytz == 2025.*
 pyzmq == 27.1.*
-ruamel.yaml == 0.18.*
+ruamel.yaml == 0.19.*
 tzlocal == 5.2
 requests == 2.33.*
 types-requests == 2.32.*
@@ -43,7 +43,7 @@ opencv-contrib-python == 4.11.0.*
 scipy == 1.16.*
 # OpenVino & ONNX
 openvino == 2025.4.*
-onnxruntime == 1.22.*
+onnxruntime == 1.30.*
 # Embeddings
 transformers == 4.45.*
 # Generative AI
@@ -58,7 +58,7 @@ pyclipper == 1.4.*
 shapely == 2.0.*
 rapidfuzz==3.12.*
 # HailoRT
-argcomplete==2.0.*
+argcomplete==3.7.*
 contextlib2==0.6.*
 future==0.18.*
 netaddr==1.3.*

docker/main/rootfs/usr/local/go2rtc/create_config.py

@@ -15,6 +15,7 @@ from frigate.const import (
 )
 from frigate.ffmpeg_presets import parse_preset_hardware_acceleration_encode
 from frigate.util.config import find_config_file, resolve_ffmpeg_path
+from frigate.util.live_streams import raw_transcode_streams
 from frigate.util.services import (
     is_go2rtc_arbitrary_exec_allowed,
     is_restricted_go2rtc_source,
@@ -174,6 +175,17 @@ for name in list(go2rtc_config.get("streams", {})):
             del go2rtc_config["streams"][name]
             continue
 
+# add transcoded live streams; a user stream with the same name wins here and
+# fails Frigate's config validation
+transcoded_streams = raw_transcode_streams(config)
+
+if transcoded_streams:
+    if go2rtc_config.get("streams") is None:
+        go2rtc_config["streams"] = {}
+
+    for name, source in transcoded_streams.items():
+        go2rtc_config["streams"].setdefault(name, source)
+
 # add birdseye restream stream if enabled
 if config.get("birdseye", {}).get("restream", False):
     birdseye: dict[str, Any] = config.get("birdseye")

docker/rockchip/Dockerfile

@@ -25,7 +25,6 @@ RUN --mount=type=bind,from=rk-wheels,source=/rk-wheels,target=/deps/rk-wheels \
 
 WORKDIR /opt/frigate/
 COPY --from=rootfs / /
-ENV FRIGATE_IMAGE_VARIANT=rk
 COPY docker/rockchip/COCO /COCO
 COPY docker/rockchip/conv2rknn.py /opt/conv2rknn.py
 

docker/rocm/Dockerfile

@@ -44,7 +44,6 @@ RUN echo "deb http://deb.debian.org/debian trixie main" > /etc/apt/sources.list.
 
 WORKDIR /opt/frigate
 COPY --from=rootfs / /
-ENV FRIGATE_IMAGE_VARIANT=rocm
 
 RUN wget -q https://bootstrap.pypa.io/get-pip.py -O get-pip.py \
     && sed -i 's/args.append("setuptools")/args.append("setuptools==77.0.3")/' get-pip.py \

docker/rpi/Dockerfile

@@ -15,4 +15,3 @@ ENV INCLUDED_FFMPEG_VERSIONS="${DEFAULT_FFMPEG_VERSION}:${INCLUDED_FFMPEG_VERSIO
 
 WORKDIR /opt/frigate/
 COPY --from=rootfs / /
-ENV FRIGATE_IMAGE_VARIANT=rpi

docker/synaptics/Dockerfile

@@ -22,7 +22,6 @@ pip3 install --no-deps -U /deps/synap-wheels/*.whl
 
 WORKDIR /opt/frigate/
 COPY --from=rootfs / /
-ENV FRIGATE_IMAGE_VARIANT=synaptics
 
 COPY --from=synap1680-wheels /rootfs/usr/local/lib/*.so /usr/lib
 

docker/tensorrt/Dockerfile.amd64

@@ -25,7 +25,6 @@ RUN --mount=type=bind,from=trt-wheels,source=/trt-wheels,target=/deps/trt-wheels
     && pip3 install -U /deps/trt-wheels/*.whl
 
 COPY --from=rootfs / /
-ENV FRIGATE_IMAGE_VARIANT=tensorrt
 COPY docker/tensorrt/detector/rootfs/etc/ld.so.conf.d /etc/ld.so.conf.d
 RUN ldconfig
 

docker/tensorrt/Dockerfile.arm64

@@ -151,7 +151,6 @@ RUN --mount=type=bind,from=trt-wheels,source=/trt-wheels,target=/deps/trt-wheels
 
 WORKDIR /opt/frigate/
 COPY --from=rootfs / /
-ENV FRIGATE_IMAGE_VARIANT=tensorrt-jp6
 
 # Fixes "Error importing detector runtime: /usr/lib/aarch64-linux-gnu/libstdc++.so.6: cannot allocate memory in static TLS block"
 ENV LD_PRELOAD /usr/lib/aarch64-linux-gnu/libstdc++.so.6

docs/docs/configuration/advanced/analytics.md

@@ -1,41 +0,0 @@
----
-id: analytics
-title: Anonymous Analytics
----
-
-import AnalyticsFields from "@site/src/components/AnalyticsFields";
-import NavPath from "@site/src/components/NavPath";
-
-Frigate can send one anonymous usage report a day. The reports show the maintainers which hardware to support, which features people use, and how releases perform. Sharing is off until you turn it on.
-
-## Turning it on
-
-Enable **Share anonymous analytics** at <NavPath path="Settings > System > Telemetry" />, or set it in your config:
-
-```yaml
-telemetry:
-  analytics: true
-```
-
-The same page has a **Preview the report** button that shows exactly what the next report contains.
-
-## How it's sent
-
-- Once a day, as a JSON POST to `https://analytics.frigate.video/report`
-- The server looks up your country and region from your IP address and never stores the address
-- Raw reports are kept for 60 days; only aggregate totals are published
-- A random install ID, stored in `/config/.analytics.json`, keeps your install from being counted twice. Turning sharing off deletes it
-
-## What's never sent
-
-- Camera, zone, group, profile, or user names
-- Object labels, face names, or license plate text
-- IP addresses, hostnames, URLs, or stream paths
-- Credentials or API keys
-- Events, recordings, or anything from them
-
-## Every field
-
-Fields marked public appear in the published totals. The machine-readable schema is [frigate-analytics-schema.json](pathname:///frigate-analytics-schema.json).
-
-<AnalyticsFields />

docs/docs/configuration/advanced/reference.md

@@ -900,6 +900,21 @@ live:
   streams:
     main_stream: main_stream_name
     sub_stream: sub_stream_name
+  # Optional: Lower-quality live streams transcoded by go2rtc while someone is watching.
+  # NOTE: Set at the camera level only.
+  transcode:
+    # Optional: Enable transcoded streams (default: shown below)
+    enabled: False
+    # Optional: go2rtc stream to transcode (default: the first live stream)
+    source: main_stream_name
+    # Optional: One transcoded stream per quality (default: shown below)
+    qualities:
+      - height: 720
+        bitrate: 1200
+      - height: 480
+        bitrate: 500
+      - height: 360
+        bitrate: 250
   # Optional: Set the height of the jsmpeg stream. (default: 720)
   # This must be less than or equal to the height of the detect stream. Lower resolutions
   # reduce bandwidth required for viewing the jsmpeg stream. Width is computed to match known aspect ratio.
@@ -1194,9 +1209,6 @@ ui:
 
 # Optional: Telemetry configuration
 telemetry:
-  # Optional: Share one anonymous usage report a day (default: shown below)
-  # NOTE: See https://docs.frigate.video/configuration/advanced/analytics for what is sent
-  analytics: False
   # Optional: Enabled network interfaces for bandwidth stats monitoring (default: empty list, let nethogs search all)
   network_interfaces:
     - eth

docs/docs/configuration/ffmpeg_presets.md

@@ -17,17 +17,19 @@ Hardware acceleration arguments tell FFmpeg to decode your camera's video stream
 
 See [the hardware acceleration docs](/configuration/hardware_acceleration_video.md) for details on setting up hardware acceleration for your GPU / iGPU, then select the preset that matches your hardware.
 
-| Preset (YAML config)  | UI Label                | Usage                             | Notes                                                           |
+| Preset (YAML config)      | UI Label                | Usage                                         | Notes                                                           |
-| --------------------- | ----------------------- | --------------------------------- | --------------------------------------------------------------- |
+| ------------------------- | ----------------------- | --------------------------------------------- | --------------------------------------------------------------- |
-| preset-rpi-64-h264    | Raspberry Pi (H.264)    | 64-bit Raspberry Pi, H.264 stream |                                                                 |
+| preset-rpi-64-h264        | Raspberry Pi (H.264)    | 64-bit Raspberry Pi, H.264 stream             |                                                                 |
-| preset-rpi-64-h265    | Raspberry Pi (H.265)    | 64-bit Raspberry Pi, H.265 stream |                                                                 |
+| preset-rpi-64-h265        | Raspberry Pi (H.265)    | 64-bit Raspberry Pi, H.265 stream             |                                                                 |
-| preset-vaapi          | VAAPI (Intel/AMD GPU)   | Intel or AMD GPU via VAAPI        | Check the hwaccel docs to ensure the correct driver is selected |
+| preset-apple-silicon-h264 | Apple Silicon (H.264)   | Apple Silicon Mac under lighter, H.264 stream | Needs the `lighter.sh/video` device                             |
-| preset-intel-qsv-h264 | Intel QuickSync (H.264) | Intel QuickSync, H.264 stream     | If you have issues, use the VAAPI preset instead                |
+| preset-apple-silicon-h265 | Apple Silicon (H.265)   | Apple Silicon Mac under lighter, H.265 stream | Needs the `lighter.sh/video` device                             |
-| preset-intel-qsv-h265 | Intel QuickSync (H.265) | Intel QuickSync, H.265 stream     | If you have issues, use the VAAPI preset instead                |
+| preset-vaapi              | VAAPI (Intel/AMD GPU)   | Intel or AMD GPU via VAAPI                    | Check the hwaccel docs to ensure the correct driver is selected |
-| preset-nvidia         | NVIDIA GPU              | NVIDIA GPU                        |                                                                 |
+| preset-intel-qsv-h264     | Intel QuickSync (H.264) | Intel QuickSync, H.264 stream                 | If you have issues, use the VAAPI preset instead                |
-| preset-jetson-h264    | NVIDIA Jetson (H.264)   | NVIDIA Jetson, H.264 stream       |                                                                 |
+| preset-intel-qsv-h265     | Intel QuickSync (H.265) | Intel QuickSync, H.265 stream                 | If you have issues, use the VAAPI preset instead                |
-| preset-jetson-h265    | NVIDIA Jetson (H.265)   | NVIDIA Jetson, H.265 stream       |                                                                 |
+| preset-nvidia             | NVIDIA GPU              | NVIDIA GPU                                    |                                                                 |
-| preset-rkmpp          | Rockchip RKMPP          | Rockchip MPP                      | Use an image with the `-rk` suffix and run in privileged mode   |
+| preset-jetson-h264        | NVIDIA Jetson (H.264)   | NVIDIA Jetson, H.264 stream                   |                                                                 |
+| preset-jetson-h265        | NVIDIA Jetson (H.265)   | NVIDIA Jetson, H.265 stream                   |                                                                 |
+| preset-rkmpp              | Rockchip RKMPP          | Rockchip MPP                                  | Use an image with the `-rk` suffix and run in privileged mode   |
 
 <ConfigTabs>
 <TabItem value="ui">

docs/docs/configuration/hardware_acceleration_video.md

@@ -43,6 +43,10 @@ Frigate supports presets for optimal hardware accelerated video decoding:
 
 - [RKNN](#rockchip-platform): Frigate can utilize the media engine in RockChip SOCs to accelerate video decoding.
 
+**Apple Silicon Mac** <CommunityBadge />
+
+- [lighter](#apple-silicon-mac-lighter): Frigate can utilize the media engine in Apple Silicon Macs to accelerate video decoding, when running under the lighter container runtime.
+
 **Other Hardware**
 
 Depending on your system, these presets may not be compatible, and you may need to use manual hwaccel args to take advantage of your hardware. More information on hardware accelerated decoding for ffmpeg can be found here: https://trac.ffmpeg.org/wiki/HWAccelIntro
@@ -533,3 +537,35 @@ output_args:
 Make sure that your SoC supports hardware acceleration for your input stream and your input stream is h264 encoding. For example, if your camera streams with h264 encoding, your SoC must be able to de- and encode with it. If you are unsure whether your SoC meets the requirements, take a look at the datasheet.
 
 :::
+
+## Apple Silicon Mac (lighter)
+
+[lighter](https://github.com/fieldwork-ai/lighter) is an open-source container runtime for macOS. It gives a container the Mac's media engine as a standard V4L2 decoder, backed by VideoToolbox, so Frigate decodes H.264 and H.265 streams in hardware with the ffmpeg it already ships. It works on M1 and newer Macs with lighter 0.9.2 or newer.
+
+Give the container the video device. With Docker Compose:
+
+```yaml {4-5}
+services:
+  frigate:
+    ...
+    devices:
+      - lighter.sh/video=all
+```
+
+Or with `docker run`, add `--device lighter.sh/video=all`.
+
+Then set the preset for the codec your cameras stream. The decoder is specific to the codec, so if your cameras mix H.264 and H.265, set the preset for the most common codec globally and override it on the other cameras:
+
+```yaml
+ffmpeg:
+  hwaccel_args: preset-apple-silicon-h264
+
+cameras:
+  garage: # an H.265 camera
+    ffmpeg:
+      hwaccel_args: preset-apple-silicon-h265
+```
+
+The presets decode on the media engine and encode the Birdseye restream and timelapses there too. Scaling to the detect resolution runs on the CPU, as ffmpeg's V4L2 decoders cannot scale.
+
+lighter can also run object detection on the Mac's Neural Engine; see [Apple Neural Engine (lighter)](object_detectors.md#apple-neural-engine-lighter).

docs/docs/configuration/live.md

@@ -92,7 +92,7 @@ go2rtc:
 
 ### Setting Streams For Live UI
 
-You can configure Frigate to allow manual selection of the stream you want to view in the Live UI. For example, you may want to view your camera's substream on mobile devices, but the full resolution stream on desktop devices. Setting the streams list will populate a dropdown in the UI's Live view that allows you to choose between the streams. This stream setting is _per device_ and is saved in your browser's local storage.
+You can configure Frigate to allow manual selection of the stream you want to view in the Live UI. For example, you may want to view your camera's substream on mobile devices, but the full resolution stream on desktop devices. Setting the streams list will populate a dropdown in the UI's Live view that allows you to choose between the streams. This stream setting is _per device_ and is saved in your browser's local storage. When a camera has more than one stream, the dropdown also offers **Auto**, which is used until you pick a specific stream. Auto starts on the first stream, steps down the list when your connection can't keep up, and steps back up when it recovers. To retry the top stream right away, select **Try highest quality** under the stream picker. List streams from highest to lowest quality, and avoid names that are plain numbers (such as `720`), which the browser sorts ahead of the others. In the UI, drag streams to reorder them, or use **Auto order** to sort them by measured bitrate.
 
 Additionally, when creating and editing camera groups in the UI, you can choose the stream you want to use for your camera group's Live dashboard.
 
@@ -158,6 +158,26 @@ cameras:
 </TabItem>
 </ConfigTabs>
 
+### Transcoded streams
+
+When a camera has no suitable sub stream, Frigate can add lower-quality streams that go2rtc transcodes to H.264 while someone is watching. They appear in the stream list like any other stream, so Auto mode can step down to them. Enable them under <NavPath path="Settings > Camera configuration > Live playback" />, or in YAML:
+
+```yaml
+cameras:
+  test_cam:
+    live:
+      transcode:
+        enabled: true
+        source: test_cam # optional, defaults to the first live stream
+        qualities:
+          - height: 720
+            bitrate: 1200 # kbps
+          - height: 480
+            bitrate: 500
+```
+
+Each quality becomes a go2rtc stream named `<camera>_transcode_<height>p`. go2rtc picks a hardware encoder automatically and falls back to the CPU, which costs CPU for each transcode while it is being watched. Check go2rtc's `api/ffmpeg/hardware` page to see which encoder it found. Using a sub stream as the `source` lowers the cost.
+
 ### WebRTC extra configuration:
 
 WebRTC works by creating a TCP or UDP connection on port `8555`. However, it requires additional configuration:
@@ -363,6 +383,13 @@ When your browser runs into problems playing back your camera streams, it will l
     - `Safari reported InvalidStateError.`
     - `Safari reported decoding errors.`
 
+- **mse-codec**
+  - What it means: go2rtc has no codec for this stream that the browser can play.
+  - What to try: Pick a stream with a codec the browser supports (H.264 is the most compatible), or use a browser that supports the stream's codec. In Auto, Frigate skips this stream for the rest of the session.
+
+  - Possible console messages from the player code:
+    - `mse: streams: codecs not matched: ...`
+
 - **stalled**
   - What it means: Playback has stalled because the player has fallen too far behind live (extended buffering or no data arriving).
   - What to try: This is usually indicative of the browser struggling to decode too many high-resolution streams at once. Try selecting a lower-bandwidth stream (substream), reduce the number of live streams open, improve the network connection, or lower the camera resolution. Also check your camera's keyframe (I-frame) interval: shorter intervals make playback start and recover faster. You can also try increasing the timeout value in <NavPath path="Settings > UI" /> .

docs/docs/configuration/object_detectors.md

@@ -34,6 +34,7 @@ Frigate supports multiple different detectors that work on different types of ha
 **Apple Silicon**
 
 - [Apple Silicon](#apple-silicon-detector): Apple Silicon can run on M1 and newer Apple Silicon devices.
+- <CommunityBadge /> [ONNX](#apple-neural-engine-lighter): the ONNX detector runs on the Neural Engine of M1 and newer Macs when Frigate runs under the lighter container runtime.
 
 **Intel**
 
@@ -484,7 +485,7 @@ See [ONNX supported models](#onnx) for supported models, there are some caveats:
 
 ## ONNX
 
-ONNX is an open format for building machine learning models, Frigate supports running ONNX models on CPU, OpenVINO, ROCm, and TensorRT. On startup Frigate will automatically try to use a GPU if one is available.
+ONNX is an open format for building machine learning models, Frigate supports running ONNX models on CPU, OpenVINO, ROCm, TensorRT, and a Mac's Neural Engine. On startup Frigate will automatically try to use a GPU if one is available.
 
 :::info
 
@@ -500,6 +501,9 @@ If the correct build is used for your GPU then the GPU will be detected and used
   - Nvidia GPUs will automatically be detected and used with the ONNX detector in the `-tensorrt` Frigate image.
   - Jetson devices will automatically be detected and used with the ONNX detector in the `-tensorrt-jp6` Frigate image.
 
+- **Apple Silicon Mac** <CommunityBadge />
+  - The Neural Engine will automatically be detected and used with the ONNX detector when Frigate runs under lighter with its Neural Engine device. See [Apple Neural Engine (lighter)](#apple-neural-engine-lighter).
+
 :::
 
 :::tip
@@ -515,6 +519,22 @@ models:
 
 :::
 
+### Apple Neural Engine (lighter) {#apple-neural-engine-lighter}
+
+[lighter](https://github.com/fieldwork-ai/lighter) is an open-source container runtime for macOS. A container started with its `lighter.sh/ane` device gets an ONNX Runtime execution provider that runs models on the Mac's Neural Engine, and the ONNX detector uses it automatically, with the same models and configuration as on any other hardware. It works on M1 and newer Macs with lighter 0.9.2 or newer.
+
+Give the Frigate container the Neural Engine device. With Docker Compose:
+
+```yaml
+services:
+  frigate:
+    image: ghcr.io/blakeblackshear/frigate:stable-standard-arm64
+    devices:
+      - lighter.sh/ane=all
+```
+
+Or with `docker run`, add `--device lighter.sh/ane=all`. Frigate then reports the Neural Engine under **Settings > System > Detection models**, and the ONNX detector's model loads on it. lighter can also decode camera streams on the Mac's media engine; see [Video Decoding](hardware_acceleration_video.md#apple-silicon-mac-lighter).
+
 ### Configuration {#configuration-onnx}
 
 <ModelConfigDropdown detectorTitle="ONNX" models={objectDetectorsModels.onnx.models} />

docs/docs/frigate/hardware.md

@@ -78,6 +78,10 @@ Frigate supports multiple different detectors that work on different types of ha
 
 **Apple Silicon**
 
+- [ONNX via lighter](#apple-silicon): The ONNX detector runs on the Neural Engine of M1 and newer Macs when Frigate runs in the lighter container runtime
+  - [Supports the same model architectures as the ONNX detector](../../configuration/object_detectors#apple-neural-engine-lighter)
+  - Runs inside the Frigate container, with no separate detector process to set up
+  - The recommended way to run Frigate on a Mac
 - [Apple Silicon](#apple-silicon): Apple Silicon is usable on all M1 and newer Apple Silicon devices to provide efficient and fast object detection
   - [Supports primarily ssdlite and mobilenet model architectures](../../configuration/object_detectors#apple-silicon-detector)
   - Runs well with any size models including large
@@ -211,7 +215,13 @@ Inference is done with the `onnx` detector type. Speeds will vary greatly depend
 
 ### Apple Silicon
 
-With the [Apple Silicon](../configuration/object_detectors.md#apple-silicon-detector) detector Frigate can take advantage of the NPU in M1 and newer Apple Silicon.
+Frigate on a Mac is best run in the [lighter](https://github.com/fieldwork-ai/lighter) container runtime, where the [ONNX detector](../configuration/object_detectors.md#apple-neural-engine-lighter) runs on the Neural Engine of M1 and newer Macs from inside the Frigate container. There is no separate detector process to install or keep running, and the same container can decode video on the Mac's media engine.
+
+| Name | YOLOv9 Inference Time                  | YOLO-NAS Inference Time | RF-DETR Inference Time |
+| ---- | -------------------------------------- | ----------------------- | ---------------------- |
+| M1   | t-320: 3.3 ms s-320: 7 ms s-640: 13 ms | 320: 6.6 ms             | Nano-320: 38 ms        |
+
+Alternatively, with the [Apple Silicon](../configuration/object_detectors.md#apple-silicon-detector) detector Frigate can take advantage of the NPU in M1 and newer Apple Silicon.
 
 :::warning
 

docs/docs/frigate/network_requirements.md

@@ -134,15 +134,6 @@ telemetry:
   version_check: false
 ```
 
-### Anonymous Analytics
-
-If [anonymous analytics](/configuration/advanced/analytics) sharing is turned on, Frigate sends one report a day to `https://analytics.frigate.video`. It's off by default, so no outbound connection happens unless you enable it:
-
-```yaml
-telemetry:
-  analytics: true
-```
-
 ### Push Notifications
 
 When [notifications](/configuration/notifications) are enabled and users have registered for push notifications in the web UI, Frigate sends push messages through the browser vendor's push service (e.g., Google FCM, Mozilla autopush). This requires internet access from the Frigate server to these push endpoints.
@@ -179,7 +170,7 @@ To run Frigate in an air-gapped or offline environment:
 2. **Pre-download the training base weights**: If you plan to train custom classification models, set `TF_KERAS_MOBILENET_V2_WEIGHTS_URL` before training, then run one training job while online. Without this variable the base weights are cached outside `/config/` and are lost whenever the container is recreated, so a later training run will fail offline. If the machine never has internet access, copy the weights in manually as described below.
 3. **Disable version check**: Set `telemetry.version_check: false` in your configuration.
 4. **Block outbound model requests**: Set the `HF_HUB_OFFLINE=1` and `TRANSFORMERS_OFFLINE=1` environment variables to prevent HuggingFace and Transformers from attempting any network requests.
-5. **Avoid cloud features**: Do not configure Frigate+, Generative AI providers that require internet, or cloud MQTT brokers, and leave anonymous analytics off (its default).
+5. **Avoid cloud features**: Do not configure Frigate+, Generative AI providers that require internet, or cloud MQTT brokers.
 6. **Use local model mirrors**: If limited internet is available, set the `HF_ENDPOINT`, `GITHUB_ENDPOINT`, `GITHUB_RAW_ENDPOINT`, and `TF_KERAS_MOBILENET_V2_WEIGHTS_URL` environment variables to point to local mirrors.
 
 After these steps, Frigate will operate with no outbound internet connections.

docs/docs/troubleshooting/faqs.md

@@ -184,6 +184,6 @@ Filters and masks only hide the incorrect result - they don't teach Frigate what
 
 ### Where do I see problems Frigate has detected?
 
-Open System > Health. The Notices list keeps a record of problems Frigate has found, and you can dismiss any entry to acknowledge it. Ongoing conditions, such as an offline camera or recordings deleted before their retention period, appear in the status bar for admins until they clear, and the status bar links to the Notices list while it has undismissed entries. On mobile, tap the warning icon in the bottom navigation bar to see them.
+Open System > Health. The Notices list keeps a record of problems Frigate has found. Acknowledge an entry to hide it until the problem happens again, or mute it to hide it for good. Hidden entries stay listed under Show hidden in the filter. Ongoing conditions, such as an offline camera or recordings deleted before their retention period, appear in the status bar for admins until they clear, and the status bar links to the Notices list while it has entries showing. On mobile, tap the warning icon in the bottom navigation bar to see them.
 
 The Hardware section below the notices shows whether the detection hardware, hardware acceleration, and enrichment devices in your config were found and are being used, so a GPU that silently fell back to the CPU shows up as a warning. Run stream checks to probe every camera's streams for the same problems the camera wizard reports.

docs/package-lock.json

@@ -11375,15 +11375,15 @@
       }
     },
     "node_modules/image-size": {
-      "version": "2.0.2",
+      "version": "2.0.4",
-      "resolved": "https://registry.npmjs.org/image-size/-/image-size-2.0.2.tgz",
+      "resolved": "https://registry.npmjs.org/image-size/-/image-size-2.0.4.tgz",
-      "integrity": "sha512-IRqXKlaXwgSMAMtpNzZa1ZAe8m+Sa1770Dhk8VkSsP9LS+iHD62Zd8FQKs8fbPiagBE7BzoFX23cxFnwshpV6w==",
+      "integrity": "sha512-QRUkFFsRV/6fuESxb9Vkq+a0LkSrgKXuc2NEqfikiXxxN/G3tjWt5EVUlMaImRBZRZK/jRBEbYvpPYZL8t08Zw==",
       "license": "MIT",
       "bin": {
         "image-size": "bin/image-size.js"
       },
       "engines": {
-        "node": ">=16.x"
+        "node": ">=18"
       }
     },
     "node_modules/immer": {

docs/sidebars.ts

@@ -130,7 +130,6 @@ const sidebars: SidebarsConfig = {
         label: "Advanced Configuration",
         items: [
           "configuration/advanced/system",
-          "configuration/advanced/analytics",
           "configuration/advanced/reference",
           {
             type: "link",

docs/src/components/AnalyticsFields/index.jsx

@@ -1,60 +0,0 @@
-import React from "react";
-import schema from "@site/static/frigate-analytics-schema.json";
-
-function resolve(node) {
-  if (!node) return node;
-  if (node.$ref) return schema.$defs[node.$ref.split("/").pop()];
-  if (node.anyOf) {
-    const inner = node.anyOf.find((option) => option.type !== "null");
-    return inner ? resolve(inner) : node;
-  }
-  return node;
-}
-
-function rows(properties, prefix = "") {
-  return Object.entries(properties).flatMap(([name, field]) => {
-    const path = prefix ? `${prefix}.${name}` : name;
-    const row = {
-      path,
-      description: field.description,
-      isPublic: field["x-public"],
-    };
-    const target = resolve(field);
-
-    if (target?.properties) return [row, ...rows(target.properties, path)];
-
-    const values = resolve(target?.additionalProperties);
-    if (values?.properties)
-      return [row, ...rows(values.properties, `${path}.<key>`)];
-
-    const items = resolve(target?.items);
-    if (items?.properties) return [row, ...rows(items.properties, `${path}[]`)];
-
-    return [row];
-  });
-}
-
-export default function AnalyticsFields() {
-  return (
-    <table>
-      <thead>
-        <tr>
-          <th>Field</th>
-          <th>Description</th>
-          <th>Public</th>
-        </tr>
-      </thead>
-      <tbody>
-        {rows(schema.properties).map((row) => (
-          <tr key={row.path}>
-            <td>
-              <code>{row.path}</code>
-            </td>
-            <td>{row.description}</td>
-            <td>{row.isPublic ? "Yes" : "No"}</td>
-          </tr>
-        ))}
-      </tbody>
-    </table>
-  );
-}

docs/static/frigate-api.yaml

@@ -10,25 +10,6 @@ servers:
   - url: https://demo.frigate.video/api
   - url: http://localhost:5001/api
 paths:
-  /analytics/preview:
-    get:
-      tags:
-        - Analytics
-      summary: Get Analytics Preview
-      description: |-
-        **Access:** Admin role required.
-
-        Get the analytics report Frigate would send next, without sending it.
-      operationId: get_analytics_preview_analytics_preview_get
-      responses:
-        '200':
-          description: Successful Response
-          content:
-            application/json:
-              schema: {}
-      security:
-        - frigateAdminAuth: []
-      x-required-role: admin
   /auth/first_time_login:
     get:
       tags:
@@ -431,6 +412,39 @@ paths:
       security:
         - frigateAdminAuth: []
       x-required-role: admin
+  /go2rtc/streams/{stream_name}/bitrate:
+    get:
+      tags:
+        - Camera
+      summary: Go2Rtc Stream Bitrate
+      description: |-
+        **Access:** Admin role required.
+
+        Measure a go2rtc stream's bitrate over a few seconds.
+      operationId: 
+        go2rtc_stream_bitrate_go2rtc_streams__stream_name__bitrate_get
+      parameters:
+        - name: stream_name
+          in: path
+          required: true
+          schema:
+            type: string
+            title: Stream Name
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema: {}
+        '422':
+          description: Validation Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+      security:
+        - frigateAdminAuth: []
+      x-required-role: admin
   /ffprobe:
     get:
       tags:
@@ -4193,19 +4207,20 @@ paths:
         Get notices, most severe first.
 
         Args:
-            include_dismissed: Also return dismissed notices, for the history view
+            include_hidden: Also return acknowledged and muted notices, for the
+                hidden list
 
         Returns:
             The notices
       operationId: get_notices_notices_get
       parameters:
-        - name: include_dismissed
+        - name: include_hidden
           in: query
           required: false
           schema:
             type: boolean
             default: false
-            title: Include Dismissed
+            title: Include Hidden
       responses:
         '200':
           description: Successful Response
@@ -4240,16 +4255,16 @@ paths:
       security:
         - frigateAdminAuth: []
       x-required-role: admin
-  /notices/dismissed_checks:
+  /notices/muted_checks:
     get:
       tags:
         - Notices
-      summary: Get Dismissed Checks
+      summary: Get Muted Checks
       description: |-
         **Access:** Admin role required.
 
-        Get the dismissed config and stream check rows, newest first.
+        Get the muted config and stream check rows, newest first.
-      operationId: get_dismissed_checks_notices_dismissed_checks_get
+      operationId: get_muted_checks_notices_muted_checks_get
       responses:
         '200':
           description: Successful Response
@@ -4259,16 +4274,16 @@ paths:
       security:
         - frigateAdminAuth: []
       x-required-role: admin
-  /notices/dismissed:
+  /notices/hidden:
     delete:
       tags:
         - Notices
-      summary: Purge Dismissed
+      summary: Unhide All Notices
       description: |-
         **Access:** Admin role required.
 
-        Delete every dismissed notice and check row so each can show again.
+        Show every acknowledged and muted notice and check row again.
-      operationId: purge_dismissed_notices_dismissed_delete
+      operationId: unhide_all_notices_notices_hidden_delete
       responses:
         '200':
           description: Successful Response
@@ -4278,18 +4293,83 @@ paths:
       security:
         - frigateAdminAuth: []
       x-required-role: admin
-  /notices/{notice_id}/dismiss:
+  /notices/{notice_id}/acknowledge:
     post:
       tags:
         - Notices
-      summary: Dismiss Notice
+      summary: Acknowledge Notice
       description: |-
         **Access:** Admin role required.
 
-        Hide a notice or a config or stream check row.
+        Hide a notice until it happens again.
 
-        It stays hidden if the same problem happens again.
+        Config and stream check rows and the update notice never repeat, so they
-      operationId: dismiss_notice_notices__notice_id__dismiss_post
+        can only be muted.
+      operationId: acknowledge_notice_notices__notice_id__acknowledge_post
+      parameters:
+        - name: notice_id
+          in: path
+          required: true
+          schema:
+            type: string
+            title: Notice Id
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema: {}
+        '422':
+          description: Validation Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+      security:
+        - frigateAdminAuth: []
+      x-required-role: admin
+  /notices/{notice_id}/mute:
+    post:
+      tags:
+        - Notices
+      summary: Mute Notice
+      description: |-
+        **Access:** Admin role required.
+
+        Hide a notice or a config or stream check row for good.
+      operationId: mute_notice_notices__notice_id__mute_post
+      parameters:
+        - name: notice_id
+          in: path
+          required: true
+          schema:
+            type: string
+            title: Notice Id
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema: {}
+        '422':
+          description: Validation Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+      security:
+        - frigateAdminAuth: []
+      x-required-role: admin
+  /notices/{notice_id}/hidden:
+    delete:
+      tags:
+        - Notices
+      summary: Unhide Notice
+      description: |-
+        **Access:** Admin role required.
+
+        Show an acknowledged or muted notice or check row again.
+      operationId: unhide_notice_notices__notice_id__hidden_delete
       parameters:
         - name: notice_id
           in: path
@@ -7684,6 +7764,11 @@ components:
           type: boolean
           title: Skip Save
           default: false
+        replace_paths:
+          items:
+            type: string
+          type: array
+          title: Replace Paths
       type: object
       title: AppConfigSetBody
     AppPostLoginBody:

frigate/analytics/__init__.py

@@ -1 +0,0 @@
-"""Opt-in anonymous analytics reports."""

frigate/analytics/collectors/__init__.py

@@ -1 +0,0 @@
-"""One collector per report section."""

frigate/analytics/collectors/cameras.py

@@ -1,223 +0,0 @@
-"""Cameras section: counts and histograms across cameras, never per camera."""
-
-from collections import Counter
-from typing import Any
-from urllib.parse import urlsplit
-
-from frigate.analytics.collectors.common import closed, histogram
-from frigate.analytics.context import ReportContext
-from frigate.analytics.schema import (
-    CamerasSection,
-    ConnectionQuality,
-    FpsBucket,
-    HeightBucket,
-    HwaccelKey,
-    InputPresetKey,
-    RetainBucket,
-    RetainDays,
-)
-from frigate.config import CameraConfig
-from frigate.config.camera.camera import CameraTypeEnum
-from frigate.config.camera.ffmpeg import CameraInput, CameraRoleEnum
-from frigate.const import REPLAY_CAMERA_PREFIX
-
-# the upper edge of every height bucket but the last
-HEIGHT_BUCKETS = (
-    (360, HeightBucket.le_360),
-    (540, HeightBucket.h480),
-    (900, HeightBucket.h720),
-    (1260, HeightBucket.h1080),
-    (1800, HeightBucket.h1440),
-)
-RESTREAM_HOSTS = frozenset({"127.0.0.1", "localhost"})
-RESTREAM_PORT = 8554
-QUALITIES = frozenset(ConnectionQuality)
-
-
-def height_bucket(height: int) -> HeightBucket:
-    for limit, bucket in HEIGHT_BUCKETS:
-        if height <= limit:
-            return bucket
-
-    return HeightBucket.ge_2160
-
-
-def fps_bucket(fps: int) -> FpsBucket:
-    if fps <= 5:
-        return FpsBucket.le_5
-
-    if fps <= 10:
-        return FpsBucket.f6_10
-
-    return FpsBucket.gt_10
-
-
-def retain_bucket(days: float) -> RetainBucket:
-    if days <= 0:
-        return RetainBucket.zero
-
-    if days <= 7:
-        return RetainBucket.d1_7
-
-    if days <= 30:
-        return RetainBucket.d8_30
-
-    return RetainBucket.gt_30
-
-
-def preset_key(args: str | list[str], enum: Any) -> Any:
-    """The preset's name, custom for hand written args, or none."""
-    if not args:
-        return enum("none")
-
-    if isinstance(args, str) and args.startswith("preset-"):
-        return closed(enum, args.removeprefix("preset-"), enum("custom"))
-
-    return enum("custom")
-
-
-def is_restream(path: str) -> bool:
-    try:
-        url = urlsplit(path)
-        return url.hostname in RESTREAM_HOSTS and url.port == RESTREAM_PORT
-    except ValueError:
-        return False
-
-
-def role_input(camera: CameraConfig, role: CameraRoleEnum) -> CameraInput | None:
-    return next((i for i in camera.ffmpeg.inputs if role in i.roles), None)
-
-
-def object_masks(camera: CameraConfig) -> int:
-    # parsing copies camera-wide masks into every filter as global_<id>
-    own = sum(1 for mask in camera.objects.mask.values() if mask is not None)
-    per_label = sum(
-        1
-        for label_filter in camera.objects.filters.values()
-        for mask_id, mask in label_filter.mask.items()
-        if mask is not None and not mask_id.startswith("global_")
-    )
-    return own + per_label
-
-
-def collect(ctx: ReportContext) -> CamerasSection:
-    cameras = {
-        name: camera
-        for name, camera in ctx.config.cameras.items()
-        if not name.startswith(REPLAY_CAMERA_PREFIX)
-    }
-    camera_stats = ctx.stats.get("cameras", {})
-
-    flags: Counter[str] = Counter()
-    types: Counter[CameraTypeEnum] = Counter()
-    heights: Counter[HeightBucket] = Counter()
-    fps: Counter[FpsBucket] = Counter()
-    hwaccel: Counter[Any] = Counter()
-    input_presets: Counter[Any] = Counter()
-    quality: Counter[ConnectionQuality] = Counter()
-    retain: dict[str, Counter[RetainBucket]] = {
-        period: Counter() for period in ("continuous", "motion", "alerts", "detections")
-    }
-
-    for name, camera in cameras.items():
-        detect_input = role_input(camera, CameraRoleEnum.detect)
-        record_input = role_input(camera, CameraRoleEnum.record)
-
-        # config validation requires a detect input, so this never skips
-        if detect_input is None:
-            continue
-
-        types[camera.type] += 1
-        fps[fps_bucket(camera.detect.fps)] += 1
-        hwaccel[
-            preset_key(
-                detect_input.hwaccel_args or camera.ffmpeg.hwaccel_args, HwaccelKey
-            )
-        ] += 1
-        input_presets[
-            preset_key(
-                detect_input.input_args or camera.ffmpeg.input_args, InputPresetKey
-            )
-        ] += 1
-
-        if camera.detect.height:
-            heights[height_bucket(camera.detect.height)] += 1
-
-        state = camera_stats.get(name, {}).get("connection_quality")
-
-        if state in QUALITIES:
-            quality[ConnectionQuality(state)] += 1
-
-        if camera.record.enabled:
-            retain["continuous"][retain_bucket(camera.record.continuous.days)] += 1
-            retain["motion"][retain_bucket(camera.record.motion.days)] += 1
-            retain["alerts"][retain_bucket(camera.record.alerts.retain.days)] += 1
-            retain["detections"][
-                retain_bucket(camera.record.detections.retain.days)
-            ] += 1
-
-        zones = len(camera.zones)
-        flags["enabled"] += camera.enabled
-        flags["go2rtc_restream"] += any(
-            is_restream(i.path) for i in camera.ffmpeg.inputs
-        )
-        flags["separate_detect_stream"] += (
-            record_input is not None and record_input.path != detect_input.path
-        )
-        flags["detect"] += camera.detect.enabled
-        flags["record"] += camera.record.enabled
-        flags["sub_stream_record"] += camera.record.sub.enabled
-        flags["snapshots"] += camera.snapshots.enabled
-        flags["audio"] += camera.audio.enabled
-        flags["audio_transcription"] += camera.audio_transcription.enabled
-        flags["birdseye"] += camera.birdseye.enabled
-        flags["onvif"] += bool(camera.onvif.host)
-        flags["autotracking"] += camera.onvif.autotracking.enabled
-        flags["face_recognition"] += camera.face_recognition.enabled
-        flags["lpr"] += camera.lpr.enabled
-        flags["review_genai"] += camera.review.genai.enabled
-        flags["object_genai"] += camera.objects.genai.enabled
-        flags["notifications"] += camera.notifications.enabled
-        flags["zones"] += zones
-        flags["cameras_with_zones"] += zones > 0
-        flags["motion_masks"] += sum(
-            1 for mask in camera.motion.mask.values() if mask is not None
-        )
-        flags["object_masks"] += object_masks(camera)
-
-    return CamerasSection(
-        total=len(cameras),
-        enabled=flags["enabled"],
-        types=histogram(types),
-        detect_height=histogram(heights),
-        detect_fps=histogram(fps),
-        hwaccel=histogram(hwaccel),
-        input_preset=histogram(input_presets),
-        go2rtc_restream=flags["go2rtc_restream"],
-        separate_detect_stream=flags["separate_detect_stream"],
-        detect=flags["detect"],
-        record=flags["record"],
-        sub_stream_record=flags["sub_stream_record"],
-        snapshots=flags["snapshots"],
-        audio=flags["audio"],
-        audio_transcription=flags["audio_transcription"],
-        birdseye=flags["birdseye"],
-        onvif=flags["onvif"],
-        autotracking=flags["autotracking"],
-        face_recognition=flags["face_recognition"],
-        lpr=flags["lpr"],
-        review_genai=flags["review_genai"],
-        object_genai=flags["object_genai"],
-        notifications=flags["notifications"],
-        zones=flags["zones"],
-        cameras_with_zones=flags["cameras_with_zones"],
-        motion_masks=flags["motion_masks"],
-        object_masks=flags["object_masks"],
-        connection_quality=histogram(quality),
-        retain_days=RetainDays(
-            continuous=histogram(retain["continuous"]),
-            motion=histogram(retain["motion"]),
-            alerts=histogram(retain["alerts"]),
-            detections=histogram(retain["detections"]),
-        ),
-    )

frigate/analytics/collectors/common.py

@@ -1,37 +0,0 @@
-"""Helpers the section collectors share."""
-
-import math
-from collections import Counter
-from enum import Enum
-from typing import Any, TypeVar
-
-E = TypeVar("E", bound=Enum)
-
-
-def closed(enum: type[E], value: Any, fallback: E) -> E:
-    """The member for a value, or the fallback for one the enum doesn't know."""
-    try:
-        return enum(str(value))
-    except ValueError:
-        return fallback
-
-
-def rate(value: Any) -> float:
-    """A finite, non-negative number rounded to 2 decimals, else 0.
-
-    A NaN would serialize as null and fail the schema's number type.
-    """
-    try:
-        number = float(value)
-    except (TypeError, ValueError):
-        return 0.0
-
-    if not math.isfinite(number):
-        return 0.0
-
-    return round(max(number, 0.0), 2)
-
-
-def histogram(counter: "Counter[E]") -> dict[E, int]:
-    """Drop the empty buckets, since an absent key means zero."""
-    return {key: total for key, total in counter.items() if total > 0}

frigate/analytics/collectors/detection.py

@@ -1,65 +0,0 @@
-"""Detection section: models, the detectors they run on, and inference speed."""
-
-import os
-
-from frigate.analytics.collectors.common import rate
-from frigate.analytics.context import ReportContext
-from frigate.analytics.schema import DetectionModel, DetectionSection, ModelSource
-from frigate.config.config import DEFAULT_MODEL
-from frigate.const import MODEL_CACHE_DIR
-from frigate.detectors.detector_config import SceneEnum
-from frigate.detectors.detector_types import DetectorTypeEnum
-from frigate.detectors.device import runner_names
-
-# the paths FrigateConfig fills in for a model that sets none
-BUNDLED_MODEL_PATHS = frozenset(
-    {"/cpu_model.tflite", "/edgetpu_model.tflite", str(DEFAULT_MODEL["path"])}
-)
-
-
-def model_source(path: str | None) -> ModelSource:
-    """Default, Frigate+ (a cached model next to its info file), or custom.
-
-    Parsing rewrites plus://<id> to the model cache, so the prefix is gone by now.
-    """
-    if path is None or path in BUNDLED_MODEL_PATHS:
-        return ModelSource.default
-
-    if path.startswith(f"{MODEL_CACHE_DIR}/") and os.path.isfile(f"{path}.json"):
-        return ModelSource.plus
-
-    return ModelSource.custom
-
-
-def collect(ctx: ReportContext) -> DetectionSection:
-    config = ctx.config
-    detectors = ctx.stats.get("detectors", {})
-    model_specs = [(model, config.devices_for_model(model)) for model in config.models]
-
-    # FrigateApp.start_detectors names the processes in this same order
-    names = iter(runner_names([spec for _, specs in model_specs for spec in specs]))
-    models: dict[SceneEnum, DetectionModel] = {}
-
-    for model, specs in model_specs:
-        speeds: list[float] = []
-
-        for _ in specs:
-            speed = detectors.get(next(names), {}).get("inference_speed")
-
-            if isinstance(speed, int | float) and speed > 0:
-                speeds.append(float(speed))
-
-        models[model.scene] = DetectionModel(
-            detector=DetectorTypeEnum(specs[0].detector),
-            devices=len(specs),
-            model_type=model.model_type,
-            input=f"{model.width}x{model.height}",
-            source=model_source(model.path),
-            inference_ms=rate(sum(speeds) / len(speeds)) if speeds else None,
-        )
-
-    return DetectionSection(
-        models=models,
-        detection_fps=rate(ctx.stats.get("detection_fps")),
-        skipped_fps=rate(ctx.stats.get("skipped_fps")),
-    )

frigate/analytics/collectors/features.py

@@ -1,145 +0,0 @@
-"""Features section: enrichments, GenAI, integrations, and users."""
-
-from collections import Counter
-
-from frigate.analytics.collectors.common import closed, histogram
-from frigate.analytics.context import ReportContext
-from frigate.analytics.schema import (
-    BirdseyeUsage,
-    ClassificationUsage,
-    EnrichmentDevice,
-    EnrichmentUsage,
-    FeaturesSection,
-    GenAIUsage,
-    SemanticSearchModel,
-    SemanticSearchUsage,
-    TranscriptionModel,
-    TranscriptionUsage,
-    UserRole,
-)
-from frigate.config.camera.genai import GenAIProviderEnum, GenAIRoleEnum
-from frigate.const import REPLAY_CAMERA_PREFIX
-from frigate.models import User
-
-RUNTIME_DEVICES = {
-    "cpu": EnrichmentDevice.cpu,
-    "cuda": EnrichmentDevice.cuda,
-    "tensorrt": EnrichmentDevice.tensorrt,
-    "migraphx": EnrichmentDevice.migraphx,
-}
-OPENVINO_DEVICES = {
-    "cpu": EnrichmentDevice.openvino_cpu,
-    "gpu": EnrichmentDevice.openvino_gpu,
-    "npu": EnrichmentDevice.openvino_npu,
-}
-
-
-def enrichment_device(label: object) -> EnrichmentDevice | None:
-    """Map a runner's device label, like "CUDA" or "OpenVINO GPU.0,CPU"."""
-    if not isinstance(label, str) or not label:
-        return None
-
-    runtime, _, target = label.partition(" ")
-
-    if runtime == "OpenVINO":
-        first = target.split(",")[0].split(".")[0].strip().lower()
-        return OPENVINO_DEVICES.get(first, EnrichmentDevice.other)
-
-    return RUNTIME_DEVICES.get(label.lower(), EnrichmentDevice.other)
-
-
-def model_name(model: object) -> str | None:
-    if model is None:
-        return None
-
-    return str(getattr(model, "value", model))
-
-
-def semantic_model(model: object) -> SemanticSearchModel | None:
-    # any string that isn't a built-in model names a GenAI provider
-    name = model_name(model)
-
-    if name is None:
-        return None
-
-    if name in ("jinav1", "jinav2"):
-        return SemanticSearchModel(name)
-
-    return SemanticSearchModel.genai
-
-
-def transcription_model(model: object) -> TranscriptionModel | None:
-    name = model_name(model)
-
-    if name is None:
-        return None
-
-    return TranscriptionModel.whisper if name == "whisper" else TranscriptionModel.genai
-
-
-def users() -> dict[UserRole, int]:
-    roles: Counter[UserRole] = Counter(
-        closed(UserRole, user.role, UserRole.custom) for user in User.select(User.role)
-    )
-    return histogram(roles)
-
-
-def collect(ctx: ReportContext) -> FeaturesSection:
-    config = ctx.config
-    devices = ctx.stats.get("embeddings", {}).get("devices", {})
-    cameras = [
-        camera
-        for name, camera in config.cameras.items()
-        if not name.startswith(REPLAY_CAMERA_PREFIX)
-    ]
-    providers: Counter[GenAIProviderEnum] = Counter(
-        genai.provider for genai in config.genai.values()
-    )
-    roles: Counter[GenAIRoleEnum] = Counter(
-        role for genai in config.genai.values() for role in genai.roles
-    )
-    custom = list(config.classification.custom.values())
-
-    return FeaturesSection(
-        face_recognition=EnrichmentUsage(
-            enabled=config.face_recognition.enabled,
-            model_size=config.face_recognition.model_size,
-            device=enrichment_device(devices.get("face_recognition")),
-        ),
-        lpr=EnrichmentUsage(
-            enabled=config.lpr.enabled,
-            model_size=config.lpr.model_size,
-            device=enrichment_device(devices.get("lpr")),
-        ),
-        semantic_search=SemanticSearchUsage(
-            enabled=config.semantic_search.enabled,
-            model=semantic_model(config.semantic_search.model),
-            model_size=config.semantic_search.model_size,
-            device=enrichment_device(devices.get("semantic_search")),
-            triggers=sum(len(camera.semantic_search.triggers) for camera in cameras),
-        ),
-        audio_transcription=TranscriptionUsage(
-            enabled=config.audio_transcription.enabled,
-            model=transcription_model(config.audio_transcription.model),
-            model_size=config.audio_transcription.model_size,
-        ),
-        genai=GenAIUsage(providers=histogram(providers), roles=histogram(roles)),
-        classification_models=ClassificationUsage(
-            state=sum(1 for model in custom if model.state_config is not None),
-            object=sum(1 for model in custom if model.object_config is not None),
-        ),
-        birdseye=BirdseyeUsage(
-            enabled=config.birdseye.enabled,
-            modes=list(config.birdseye.modes),
-            restream=config.birdseye.restream,
-        ),
-        mqtt=config.mqtt.enabled,
-        notifications=config.notifications.enabled,
-        auth=config.auth.enabled,
-        proxy_auth=config.proxy.header_map.user is not None,
-        tls=config.tls.enabled,
-        users=users(),
-        camera_groups=len(config.camera_groups),
-        profiles=len(config.profiles),
-        plus_api_key=config.plus_api.is_active(),
-    )

frigate/analytics/collectors/hardware.py

@@ -1,107 +0,0 @@
-"""Hardware section: CPU, memory, GPUs, decode and detection hardware, storage."""
-
-import os
-from collections import Counter
-from typing import Any
-
-import psutil
-
-from frigate.analytics.collectors.common import closed, histogram
-from frigate.analytics.context import ReportContext
-from frigate.analytics.schema import (
-    DecodeFamily,
-    GpuInfo,
-    GpuVendor,
-    HardwareKey,
-    HardwareSection,
-    StorageInfo,
-)
-from frigate.const import RECORD_DIR
-from frigate.detectors.hardware import hardware_prober
-from frigate.util.hwaccel import hwaccel_options
-
-DEVICE_TREE_MODEL = "/proc/device-tree/model"
-CPUINFO = "/proc/cpuinfo"
-
-
-def cpu_model() -> str:
-    """The board model on ARM boards, else the CPU's model name."""
-    try:
-        with open(DEVICE_TREE_MODEL) as f:
-            board = f.read().strip("\x00\n ")
-
-        if board:
-            return board[:64]
-    except OSError:
-        pass
-
-    try:
-        with open(CPUINFO) as f:
-            for line in f:
-                key, _, value = line.partition(":")
-
-                if key.strip() == "model name" and value.strip():
-                    return value.strip()[:64]
-    except OSError:
-        pass
-
-    return "unknown"
-
-
-def gpus(stats: dict[str, Any]) -> list[GpuInfo]:
-    found: list[GpuInfo] = []
-
-    for name, entry in stats.get("gpu_usages", {}).items():
-        vendor = entry.get("vendor") if isinstance(entry, dict) else None
-        found.append(
-            GpuInfo(
-                vendor=closed(GpuVendor, vendor, GpuVendor.other),
-                name=str(name)[:64],
-            )
-        )
-
-    return found
-
-
-def decode_families() -> list[DecodeFamily]:
-    _, available = hwaccel_options()
-    families = [
-        closed(DecodeFamily, family.key, DecodeFamily.other) for family in available
-    ]
-    return list(dict.fromkeys(families))
-
-
-def detection_hardware() -> dict[HardwareKey, int]:
-    units: Counter[HardwareKey] = Counter()
-
-    for found in hardware_prober.probe():
-        units[closed(HardwareKey, found.key, HardwareKey.other)] += found.count
-
-    return histogram(units)
-
-
-def storage(stats: dict[str, Any]) -> StorageInfo:
-    # stats report sizes in MB
-    entry = stats.get("service", {}).get("storage", {}).get(RECORD_DIR) or {}
-    total_mb = float(entry.get("total") or 0)
-    used_mb = float(entry.get("used") or 0)
-
-    return StorageInfo(
-        record_fs=str(entry.get("mount_type") or "unknown")[:16],
-        record_total_gb=round(total_mb / 1024),
-        record_used_pct=min(round(used_mb / total_mb * 100), 100)
-        if total_mb > 0
-        else 0,
-    )
-
-
-def collect(ctx: ReportContext) -> HardwareSection:
-    return HardwareSection(
-        cpu_model=cpu_model(),
-        cpu_cores=os.cpu_count() or 0,
-        memory_gb=round(psutil.virtual_memory().total / 2**30),
-        gpus=gpus(ctx.stats),
-        decode_families=decode_families(),
-        detection_hardware=detection_hardware(),
-        storage=storage(ctx.stats),
-    )

frigate/analytics/collectors/health.py

@@ -1,59 +0,0 @@
-"""Health section: uptime, CPU, enrichment speed, and notice counts."""
-
-from typing import Any
-
-from frigate.analytics.collectors.common import rate
-from frigate.analytics.context import ReportContext
-from frigate.analytics.schema import (
-    EnrichmentTiming,
-    HealthSection,
-    NoticeCounts,
-    NoticeKindKey,
-)
-
-TIMING_STATS = {
-    EnrichmentTiming.face: "face_recognition_speed",
-    EnrichmentTiming.lpr: "plate_recognition_speed",
-    EnrichmentTiming.plate_detection: "yolov9_plate_detection_speed",
-    EnrichmentTiming.image_embedding: "image_embedding_speed",
-    EnrichmentTiming.text_embedding: "text_embedding_speed",
-    EnrichmentTiming.review_description: "review_description_speed",
-    EnrichmentTiming.object_description: "object_description_speed",
-}
-REPORTABLE_KINDS = frozenset(key.value for key in NoticeKindKey)
-
-
-def notice_deltas(notice_stats: list[dict[str, Any]]) -> dict[Any, NoticeCounts]:
-    """What changed since the last accepted report, per reportable kind."""
-    deltas: dict[Any, NoticeCounts] = {}
-
-    for row in notice_stats:
-        if row["kind"] not in REPORTABLE_KINDS:
-            continue
-
-        occurrences = max(row["occurrences"] - row["reported_occurrences"], 0)
-        dismissals = max(row["dismissals"] - row["reported_dismissals"], 0)
-
-        if occurrences or dismissals:
-            deltas[NoticeKindKey(row["kind"])] = NoticeCounts(
-                occurrences=occurrences, dismissals=dismissals
-            )
-
-    return deltas
-
-
-def collect(ctx: ReportContext) -> HealthSection:
-    service = ctx.stats.get("service", {})
-    embeddings = ctx.stats.get("embeddings", {})
-    cpu = ctx.stats.get("cpu_usages", {}).get("frigate.full_system", {}).get("cpu")
-    timings = {
-        timing: rate(embeddings.get(key)) for timing, key in TIMING_STATS.items()
-    }
-
-    return HealthSection(
-        uptime_hours=int(rate(service.get("uptime")) // 3600),
-        cpu_percent=min(round(rate(cpu)), 100),
-        enrichment_ms={timing: value for timing, value in timings.items() if value > 0},
-        retention_unmet=bool(service.get("retention_unmet", False)),
-        notices=notice_deltas(ctx.notice_stats),
-    )

frigate/analytics/collectors/install.py

@@ -1,63 +0,0 @@
-"""Install section: version, image variant, install type, platform."""
-
-import os
-import platform
-import re
-
-from frigate.analytics.collectors.common import closed
-from frigate.analytics.context import ReportContext
-from frigate.analytics.schema import Arch, ImageVariant, InstallSection, InstallType
-from frigate.version import VERSION
-
-KERNEL_PATTERN = re.compile(r"^(\d{1,3})\.(\d{1,3})")
-
-
-def image_variant(value: str | None) -> ImageVariant:
-    """The published image from the build-time FRIGATE_IMAGE_VARIANT, dev when unset."""
-    if not value:
-        return ImageVariant.dev
-
-    return closed(ImageVariant, value, ImageVariant.other)
-
-
-def install_type() -> InstallType:
-    # the add-on is a container too, so it has to be checked first
-    if os.path.isfile("/data/options.json"):
-        return InstallType.ha_addon
-
-    if os.environ.get("KUBERNETES_SERVICE_HOST"):
-        return InstallType.kubernetes
-
-    if os.path.exists("/run/.containerenv"):
-        return InstallType.podman
-
-    if os.path.exists("/.dockerenv"):
-        return InstallType.docker
-
-    return InstallType.unknown
-
-
-def arch(machine: str) -> Arch:
-    match machine.lower():
-        case "x86_64" | "amd64":
-            return Arch.x86_64
-        case "aarch64" | "arm64":
-            return Arch.aarch64
-        case _:
-            return Arch.other
-
-
-def kernel(release: str) -> str:
-    match = KERNEL_PATTERN.match(release)
-    return f"{match.group(1)}.{match.group(2)}" if match else "unknown"
-
-
-def collect(ctx: ReportContext) -> InstallSection:
-    return InstallSection(
-        version=VERSION[:32],
-        image_variant=image_variant(os.environ.get("FRIGATE_IMAGE_VARIANT")),
-        install_type=install_type(),
-        arch=arch(platform.machine()),
-        kernel=kernel(platform.release()),
-        run_as_root=os.geteuid() == 0,
-    )

frigate/analytics/context.py

@@ -1,13 +0,0 @@
-"""What the collectors read, gathered once per report."""
-
-from dataclasses import dataclass, field
-from typing import Any
-
-from frigate.config import FrigateConfig
-
-
-@dataclass(frozen=True)
-class ReportContext:
-    config: FrigateConfig
-    stats: dict[str, Any]
-    notice_stats: list[dict[str, Any]] = field(default_factory=list)

frigate/analytics/report.py

@@ -1,88 +0,0 @@
-"""Build a report from the section collectors."""
-
-import logging
-import time
-from collections.abc import Callable
-from typing import TYPE_CHECKING, Any
-from uuid import uuid4
-
-from pydantic import BaseModel
-
-from frigate.analytics.collectors import (
-    cameras,
-    detection,
-    features,
-    hardware,
-    health,
-    install,
-)
-from frigate.analytics.context import ReportContext
-from frigate.analytics.schema import SCHEMA_VERSION, AnalyticsReport
-from frigate.analytics.state import load_state
-from frigate.config import FrigateConfig
-
-if TYPE_CHECKING:
-    from frigate.notices.registry import NoticeRegistry
-    from frigate.stats.emitter import StatsEmitter
-
-logger = logging.getLogger(__name__)
-
-COLLECTORS: dict[str, Callable[[ReportContext], BaseModel | None]] = {
-    "install": install.collect,
-    "hardware": hardware.collect,
-    "detection": detection.collect,
-    "cameras": cameras.collect,
-    "features": features.collect,
-    "health": health.collect,
-}
-
-# shown in the preview until the first report creates a real ID
-PREVIEW_INSTALL_ID = "0" * 32
-
-
-def build_report(
-    ctx: ReportContext, install_id: str, sent_at: int | None = None
-) -> AnalyticsReport:
-    """Run every collector; one that fails sends its section as null."""
-    sections: dict[str, Any] = {}
-
-    for name, collect in COLLECTORS.items():
-        try:
-            sections[name] = collect(ctx)
-        except Exception:
-            # a collector bug must cost one section, never the whole report
-            logger.warning("Analytics %s section failed", name, exc_info=True)
-            sections[name] = None
-
-    return AnalyticsReport.model_validate(
-        {
-            "schema_version": SCHEMA_VERSION,
-            "install_id": install_id,
-            "report_id": str(uuid4()),
-            "sent_at": int(time.time()) if sent_at is None else sent_at,
-            **sections,
-        }
-    )
-
-
-def gather_context(
-    config: FrigateConfig,
-    stats_emitter: "StatsEmitter | None",
-    notice_registry: "NoticeRegistry | None",
-) -> ReportContext:
-    return ReportContext(
-        config=config,
-        stats=stats_emitter.get_latest_stats() if stats_emitter is not None else {},
-        notice_stats=notice_registry.stats() if notice_registry is not None else [],
-    )
-
-
-def preview_report(
-    config: FrigateConfig,
-    stats_emitter: "StatsEmitter | None",
-    notice_registry: "NoticeRegistry | None",
-) -> AnalyticsReport:
-    """The report the next send would carry, without sending it."""
-    state = load_state()
-    ctx = gather_context(config, stats_emitter, notice_registry)
-    return build_report(ctx, state.install_id if state else PREVIEW_INSTALL_ID)

frigate/analytics/reporter.py

@@ -1,177 +0,0 @@
-"""Send one analytics report a day while the admin has opted in."""
-
-import logging
-import random
-import threading
-import time
-from collections.abc import Callable
-from multiprocessing.synchronize import Event as MpEvent
-from typing import TYPE_CHECKING
-
-from frigate.analytics.context import ReportContext
-from frigate.analytics.report import build_report
-from frigate.analytics.state import (
-    STATE_PATH,
-    AnalyticsState,
-    delete_state,
-    load_state,
-    new_state,
-    save_state,
-)
-from frigate.analytics.transport import SendOutcome, send_report
-from frigate.config import FrigateConfig
-from frigate.config.holder import ConfigHolder
-from frigate.const import ANALYTICS_URL
-from frigate.notices import raise_notice, resolve_notice
-
-if TYPE_CHECKING:
-    from frigate.notices.registry import NoticeRegistry
-    from frigate.stats.emitter import StatsEmitter
-
-logger = logging.getLogger(__name__)
-
-WAKE_S = 10 * 60
-INTERVAL_S = 24 * 60 * 60
-JITTER_S = 60 * 60
-FIRST_DELAY_S = (15 * 60, 45 * 60)
-PROMPT_KIND = "analytics_prompt"
-
-
-class AnalyticsReporter(threading.Thread):
-    """Follows the live config, so a settings save needs no restart."""
-
-    def __init__(
-        self,
-        config_holder: ConfigHolder,
-        stats_emitter: "StatsEmitter",
-        notice_registry: "NoticeRegistry",
-        stop_event: MpEvent | threading.Event,
-        *,
-        state_path: str = STATE_PATH,
-        url: str = ANALYTICS_URL,
-        send: Callable[[str, str], SendOutcome] = send_report,
-        clock: Callable[[], float] = time.time,
-        rng: random.Random | None = None,
-    ) -> None:
-        super().__init__(name="analytics_reporter", daemon=True)
-        self.config_holder = config_holder
-        self.stats_emitter = stats_emitter
-        self.notice_registry = notice_registry
-        self.stop_event = stop_event
-        self.state_path = state_path
-        self.url = url
-        self.send = send
-        self.clock = clock
-        self.rng = rng or random.Random()
-        self.first_due = clock() + self.rng.uniform(*FIRST_DELAY_S)
-        self.interval = self._next_interval()
-        self.opted_in: bool | None = None
-        self.warned_unwritable = False
-        # a settings save runs on an API thread while a wake may be mid-attempt
-        self._lock = threading.Lock()
-        config_holder.subscribe(self._on_config)
-
-    def _next_interval(self) -> float:
-        return INTERVAL_S + self.rng.uniform(-JITTER_S, JITTER_S)
-
-    def run(self) -> None:
-        while True:
-            try:
-                self.tick()
-            except Exception:
-                logger.exception("Analytics reporter failed")
-
-            if self.stop_event.wait(WAKE_S):
-                break
-
-    def _on_config(self, config: FrigateConfig) -> None:
-        # a save can turn sharing off and back on between two wakes, so an
-        # opt-out is handled when it's saved rather than at the next wake
-        with self._lock:
-            if not config.safe_mode:
-                self._apply_consent(config.telemetry.analytics)
-
-    def _apply_consent(self, opted_in: bool) -> None:
-        # called with the lock held
-        if opted_in == self.opted_in:
-            return
-
-        self.opted_in = opted_in
-
-        if opted_in:
-            resolve_notice(PROMPT_KIND)
-        else:
-            raise_notice(PROMPT_KIND)
-            delete_state(self.state_path)
-
-    def tick(self) -> None:
-        with self._lock:
-            config = self.config_holder.config
-
-            # safe mode parses a default config where analytics reads as off,
-            # and handling that as an opt-out would delete the install ID
-            if config.safe_mode:
-                return
-
-            self._apply_consent(config.telemetry.analytics)
-
-            if not config.telemetry.analytics:
-                return
-
-            now = self.clock()
-
-            if now < self.first_due:
-                return
-
-            state = load_state(self.state_path) or new_state()
-
-            if not self._due(state.last_attempt_at, now):
-                return
-
-            # saved before sending, so a failing endpoint or a crash mid-send
-            # still waits a full interval; without saved state every boot would
-            # send under a new install ID
-            if not save_state(AnalyticsState(state.install_id, now), self.state_path):
-                if not self.warned_unwritable:
-                    logger.warning(
-                        "Analytics is on, but %s isn't writable, so no report is sent",
-                        self.state_path,
-                    )
-                    self.warned_unwritable = True
-
-                return
-
-            self.interval = self._next_interval()
-
-        # the lock stays free during the request, so a save never waits on it
-        self._send(state.install_id, now)
-
-    def _due(self, last_attempt_at: float, now: float) -> bool:
-        # a last attempt stamped in the future came from a wrong clock
-        return (
-            now >= last_attempt_at + self.interval or last_attempt_at > now + INTERVAL_S
-        )
-
-    def _send(self, install_id: str, now: float) -> None:
-        notice_stats = self.notice_registry.stats()
-        ctx = ReportContext(
-            config=self.config_holder.config,
-            stats=self.stats_emitter.get_latest_stats(),
-            notice_stats=notice_stats,
-        )
-        report = build_report(ctx, install_id, sent_at=int(now))
-        body = report.model_dump_json()
-
-        # consent can be withdrawn while the report builds
-        if not self.config_holder.config.telemetry.analytics:
-            return
-
-        if self.send(self.url, body) is not SendOutcome.accepted:
-            return
-
-        # a failed health section sent no notice counts, so they stay pending
-        if report.health is not None:
-            self.notice_registry.mark_reported(notice_stats)
-
-        logger.info("Sent the daily analytics report")
-        logger.debug("Analytics report: %s", body)

frigate/analytics/schema.py

@@ -1,407 +0,0 @@
-"""Models for the analytics report, the contract with the ingest endpoint.
-
-Every field carries a description and an x-public flag, and no field accepts
-user-entered text, so a report can't carry camera names or other free text.
-"""
-
-from enum import StrEnum
-from typing import Any
-
-from pydantic import BaseModel, ConfigDict, Field
-
-from frigate.config.camera.birdseye import BirdseyeModeEnum
-from frigate.config.camera.camera import CameraTypeEnum
-from frigate.config.camera.genai import GenAIProviderEnum, GenAIRoleEnum
-from frigate.config.classification import ModelSizeEnum
-from frigate.detectors.detector_config import ModelTypeEnum, SceneEnum
-from frigate.detectors.detector_types import DetectorTypeEnum
-from frigate.ffmpeg_presets import PRESETS_HW_ACCEL_DECODE, PRESETS_INPUT
-from frigate.notices.types import NOTICE_KINDS
-
-SCHEMA_VERSION = 1
-
-
-class ImageVariant(StrEnum):
-    standard = "standard"
-    rpi = "rpi"
-    tensorrt = "tensorrt"
-    tensorrt_jp6 = "tensorrt-jp6"
-    rocm = "rocm"
-    rk = "rk"
-    synaptics = "synaptics"
-    dev = "dev"
-    other = "other"
-
-
-class InstallType(StrEnum):
-    ha_addon = "ha_addon"
-    docker = "docker"
-    podman = "podman"
-    kubernetes = "kubernetes"
-    unknown = "unknown"
-
-
-class Arch(StrEnum):
-    x86_64 = "x86_64"
-    aarch64 = "aarch64"
-    other = "other"
-
-
-class GpuVendor(StrEnum):
-    intel = "intel"
-    amd = "amd"
-    nvidia = "nvidia"
-    rockchip = "rockchip"
-    rpi = "rpi"
-    other = "other"
-
-
-class DecodeFamily(StrEnum):
-    nvidia = "nvidia"
-    vaapi = "vaapi"
-    rkmpp = "rkmpp"
-    intel_qsv = "intel-qsv"
-    jetson = "jetson"
-    rpi = "rpi"
-    other = "other"
-
-
-class HardwareKey(StrEnum):
-    edgetpu_pci = "edgetpu:pci"
-    edgetpu_usb = "edgetpu:usb"
-    openvino_gpu = "openvino:GPU"
-    openvino_npu = "openvino:NPU"
-    onnx_amd = "onnx:amd"
-    onnx_nvidia = "onnx:nvidia"
-    tensorrt = "tensorrt"
-    hailo = "hailo"
-    memryx = "memryx"
-    deepx = "deepx"
-    rknn = "rknn"
-    axengine = "axengine"
-    synaptics = "synaptics"
-    cpu = "cpu"
-    other = "other"
-
-
-class ModelSource(StrEnum):
-    default = "default"
-    plus = "plus"
-    custom = "custom"
-
-
-class HeightBucket(StrEnum):
-    le_360 = "le_360"
-    h480 = "480"
-    h720 = "720"
-    h1080 = "1080"
-    h1440 = "1440"
-    ge_2160 = "ge_2160"
-
-
-class FpsBucket(StrEnum):
-    le_5 = "le_5"
-    f6_10 = "6_10"
-    gt_10 = "gt_10"
-
-
-class RetainBucket(StrEnum):
-    zero = "0"
-    d1_7 = "1_7"
-    d8_30 = "8_30"
-    gt_30 = "gt_30"
-
-
-class ConnectionQuality(StrEnum):
-    excellent = "excellent"
-    fair = "fair"
-    poor = "poor"
-    unusable = "unusable"
-
-
-class EnrichmentDevice(StrEnum):
-    cpu = "cpu"
-    cuda = "cuda"
-    tensorrt = "tensorrt"
-    migraphx = "migraphx"
-    openvino_cpu = "openvino_cpu"
-    openvino_gpu = "openvino_gpu"
-    openvino_npu = "openvino_npu"
-    other = "other"
-
-
-class SemanticSearchModel(StrEnum):
-    jinav1 = "jinav1"
-    jinav2 = "jinav2"
-    genai = "genai"
-
-
-class TranscriptionModel(StrEnum):
-    whisper = "whisper"
-    genai = "genai"
-
-
-class UserRole(StrEnum):
-    admin = "admin"
-    viewer = "viewer"
-    custom = "custom"
-
-
-class EnrichmentTiming(StrEnum):
-    face = "face"
-    lpr = "lpr"
-    plate_detection = "plate_detection"
-    image_embedding = "image_embedding"
-    text_embedding = "text_embedding"
-    review_description = "review_description"
-    object_description = "object_description"
-
-
-def _preset_keys(presets: dict[str, Any]) -> dict[str, str]:
-    keys = [name.removeprefix("preset-") for name in presets]
-    return {key: key for key in [*keys, "custom", "none"]}
-
-
-# built from the registries they mirror, so a new preset or notice kind reaches
-# the schema through generate_analytics_schema.py instead of a hand edit
-HwaccelKey = StrEnum("HwaccelKey", _preset_keys(PRESETS_HW_ACCEL_DECODE))  # type: ignore[misc]
-InputPresetKey = StrEnum("InputPresetKey", _preset_keys(PRESETS_INPUT))  # type: ignore[misc]
-NoticeKindKey = StrEnum(  # type: ignore[misc]
-    "NoticeKindKey",
-    {key: key for key, kind in NOTICE_KINDS.items() if kind.reportable},
-)
-
-
-class AnalyticsModel(BaseModel):
-    model_config = ConfigDict(extra="forbid")
-
-
-def metric(description: str, *, public: bool = True, **kwargs: Any) -> Any:
-    """Declare a report field; the description and flag land in the schema."""
-    return Field(
-        description=description, json_schema_extra={"x-public": public}, **kwargs
-    )
-
-
-def count(description: str) -> Any:
-    return metric(description, ge=0)
-
-
-class InstallSection(AnalyticsModel):
-    version: str = metric("Frigate version string", max_length=32)
-    image_variant: ImageVariant = metric("Published image the install runs")
-    install_type: InstallType = metric("How Frigate is installed")
-    arch: Arch = metric("CPU architecture")
-    kernel: str = metric(
-        "Host kernel as major.minor", pattern=r"^(\d{1,3}\.\d{1,3}|unknown)$"
-    )
-    run_as_root: bool = metric("Whether the main process runs as root")
-
-
-class GpuInfo(AnalyticsModel):
-    vendor: GpuVendor = metric("GPU vendor")
-    name: str = metric("GPU name as the hardware reports it", max_length=64)
-
-
-class StorageInfo(AnalyticsModel):
-    record_fs: str = metric("Filesystem of the recordings volume", max_length=16)
-    record_total_gb: int = count("Size of the recordings volume in GB")
-    record_used_pct: int = metric(
-        "Percent of the recordings volume in use", ge=0, le=100
-    )
-
-
-class HardwareSection(AnalyticsModel):
-    cpu_model: str = metric(
-        "CPU or board model as the hardware reports it", max_length=64
-    )
-    cpu_cores: int = count("Logical CPU count")
-    memory_gb: int = count("Total memory in GB")
-    gpus: list[GpuInfo] = metric("GPUs the stats collector found")
-    decode_families: list[DecodeFamily] = metric(
-        "Hardware decode families this system can use"
-    )
-    detection_hardware: dict[HardwareKey, int] = metric(
-        "Detection hardware found, as unit counts by kind"
-    )
-    storage: StorageInfo = metric("Recordings storage")
-
-
-class DetectionModel(AnalyticsModel):
-    detector: DetectorTypeEnum = metric("Detector type the model runs on")
-    devices: int = count("Devices the model runs on")
-    model_type: ModelTypeEnum = metric("Model architecture")
-    input: str = metric("Model input size as WxH", pattern=r"^\d{1,5}x\d{1,5}$")
-    source: ModelSource = metric("Where the model came from", public=False)
-    inference_ms: float | None = metric(
-        "Mean inference time across the model's detector processes, null before the first stats",
-        ge=0,
-    )
-
-
-class DetectionSection(AnalyticsModel):
-    models: dict[SceneEnum, DetectionModel] = metric("Detection models keyed by scene")
-    detection_fps: float = metric("Detections per second across cameras", ge=0)
-    skipped_fps: float = metric("Frames per second skipped across cameras", ge=0)
-
-
-class RetainDays(AnalyticsModel):
-    continuous: dict[RetainBucket, int] = metric(
-        "Recording cameras by continuous retention in days"
-    )
-    motion: dict[RetainBucket, int] = metric(
-        "Recording cameras by motion retention in days"
-    )
-    alerts: dict[RetainBucket, int] = metric(
-        "Recording cameras by alert retention in days"
-    )
-    detections: dict[RetainBucket, int] = metric(
-        "Recording cameras by detection retention in days"
-    )
-
-
-class CamerasSection(AnalyticsModel):
-    total: int = count("Configured cameras")
-    enabled: int = count("Enabled cameras")
-    types: dict[CameraTypeEnum, int] = metric("Cameras by type")
-    detect_height: dict[HeightBucket, int] = metric(
-        "Cameras by detect resolution height"
-    )
-    detect_fps: dict[FpsBucket, int] = metric("Cameras by detect fps")
-    hwaccel: dict[HwaccelKey, int] = metric(
-        "Cameras by the resolved hwaccel preset of the detect input"
-    )
-    input_preset: dict[InputPresetKey, int] = metric(
-        "Cameras by the input preset of the detect input"
-    )
-    go2rtc_restream: int = count("Cameras with an input from the go2rtc restream")
-    separate_detect_stream: int = count(
-        "Cameras whose detect input differs from their record input"
-    )
-    detect: int = count("Cameras with detection on")
-    record: int = count("Cameras with recording on")
-    sub_stream_record: int = count("Cameras with sub stream recording on")
-    snapshots: int = count("Cameras with snapshots on")
-    audio: int = count("Cameras with audio detection on")
-    audio_transcription: int = count("Cameras with audio transcription on")
-    birdseye: int = count("Cameras in birdseye")
-    onvif: int = count("Cameras with an ONVIF host")
-    autotracking: int = count("Cameras with PTZ autotracking on")
-    face_recognition: int = count("Cameras with face recognition on")
-    lpr: int = count("Cameras with license plate recognition on")
-    review_genai: int = count("Cameras with GenAI review summaries on")
-    object_genai: int = count("Cameras with GenAI object descriptions on")
-    notifications: int = count("Cameras with notifications on")
-    zones: int = count("Zones across cameras")
-    cameras_with_zones: int = count("Cameras with at least one zone")
-    motion_masks: int = count("Motion masks across cameras")
-    object_masks: int = count("Object masks across cameras")
-    connection_quality: dict[ConnectionQuality, int] = metric(
-        "Cameras by connection quality at send time"
-    )
-    retain_days: RetainDays = metric("Recording retention")
-
-
-class EnrichmentUsage(AnalyticsModel):
-    enabled: bool = metric("Whether the enrichment is on")
-    model_size: ModelSizeEnum = metric("Configured model size")
-    device: EnrichmentDevice | None = metric(
-        "Device the model loaded on, null when it isn't loaded"
-    )
-
-
-class SemanticSearchUsage(AnalyticsModel):
-    enabled: bool = metric("Whether semantic search is on")
-    model: SemanticSearchModel | None = metric(
-        "Embedding model, genai for a GenAI provider"
-    )
-    model_size: ModelSizeEnum = metric("Configured model size")
-    device: EnrichmentDevice | None = metric(
-        "Device the model loaded on, null when it isn't loaded"
-    )
-    triggers: int = count("Semantic search triggers across cameras")
-
-
-class TranscriptionUsage(AnalyticsModel):
-    enabled: bool = metric("Whether audio transcription is on")
-    model: TranscriptionModel | None = metric(
-        "Transcription model, genai for a GenAI provider"
-    )
-    model_size: ModelSizeEnum = metric("Configured model size")
-
-
-class GenAIUsage(AnalyticsModel):
-    providers: dict[GenAIProviderEnum, int] = metric(
-        "Configured GenAI providers by type"
-    )
-    roles: dict[GenAIRoleEnum, int] = metric("Configured GenAI providers by role")
-
-
-class ClassificationUsage(AnalyticsModel):
-    state: int = count("Custom state classification models")
-    object: int = count("Custom object classification models")
-
-
-class BirdseyeUsage(AnalyticsModel):
-    enabled: bool = metric("Whether birdseye is on")
-    modes: list[BirdseyeModeEnum] = metric("Birdseye modes")
-    restream: bool = metric("Whether birdseye is restreamed")
-
-
-class FeaturesSection(AnalyticsModel):
-    face_recognition: EnrichmentUsage = metric("Face recognition")
-    lpr: EnrichmentUsage = metric("License plate recognition")
-    semantic_search: SemanticSearchUsage = metric("Semantic search")
-    audio_transcription: TranscriptionUsage = metric("Audio transcription")
-    genai: GenAIUsage = metric("Generative AI providers")
-    classification_models: ClassificationUsage = metric("Custom classification models")
-    birdseye: BirdseyeUsage = metric("Birdseye")
-    mqtt: bool = metric("Whether MQTT is on")
-    notifications: bool = metric("Whether web push notifications are on")
-    auth: bool = metric("Whether authentication is on")
-    proxy_auth: bool = metric("Whether a proxy supplies the user header")
-    tls: bool = metric("Whether TLS is on")
-    users: dict[UserRole, int] = metric("Users by role")
-    camera_groups: int = count("Camera groups")
-    profiles: int = count("Profiles")
-    plus_api_key: bool = metric("Whether a Frigate+ API key is set", public=False)
-
-
-class NoticeCounts(AnalyticsModel):
-    occurrences: int = count("Occurrences since the last accepted report")
-    dismissals: int = count("Dismissals since the last accepted report")
-
-
-class HealthSection(AnalyticsModel):
-    uptime_hours: int = count("Hours since Frigate started")
-    cpu_percent: int = metric("System CPU use at send time", ge=0, le=100)
-    enrichment_ms: dict[EnrichmentTiming, float] = metric(
-        "Mean enrichment inference times in milliseconds"
-    )
-    retention_unmet: bool = metric(
-        "Whether storage can't keep the configured retention"
-    )
-    notices: dict[NoticeKindKey, NoticeCounts] = metric(
-        "Notice counts by kind since the last accepted report", public=False
-    )
-
-
-class AnalyticsReport(AnalyticsModel):
-    schema_version: int = metric("Report format version", ge=1)
-    install_id: str = metric(
-        "Random install identifier", public=False, pattern=r"^[0-9a-f]{32}$"
-    )
-    report_id: str = metric(
-        "Random identifier of this report",
-        public=False,
-        pattern=r"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
-    )
-    sent_at: int = count("Unix time the report was built")
-    install: InstallSection | None = metric("Install, null if its collector failed")
-    hardware: HardwareSection | None = metric("Hardware, null if its collector failed")
-    detection: DetectionSection | None = metric(
-        "Object detection, null if its collector failed"
-    )
-    cameras: CamerasSection | None = metric("Cameras, null if its collector failed")
-    features: FeaturesSection | None = metric("Features, null if its collector failed")
-    health: HealthSection | None = metric("Health, null if its collector failed")

frigate/analytics/state.py

@@ -1,85 +0,0 @@
-"""The install's analytics identity and last attempt time, kept under /config."""
-
-import json
-import logging
-import os
-import re
-from dataclasses import dataclass
-from uuid import uuid4
-
-from frigate.const import CONFIG_DIR
-
-logger = logging.getLogger(__name__)
-
-STATE_PATH = os.path.join(CONFIG_DIR, ".analytics.json")
-INSTALL_ID_PATTERN = re.compile(r"[0-9a-f]{32}")
-
-
-@dataclass(frozen=True)
-class AnalyticsState:
-    install_id: str
-    last_attempt_at: float
-
-
-def new_state() -> AnalyticsState:
-    return AnalyticsState(install_id=uuid4().hex, last_attempt_at=0.0)
-
-
-def load_state(path: str = STATE_PATH) -> AnalyticsState | None:
-    """The saved state, or None when the file is missing or unusable."""
-    try:
-        with open(path) as f:
-            data = json.load(f)
-    except FileNotFoundError:
-        return None
-    except (OSError, ValueError):
-        logger.warning("Ignoring unreadable analytics state at %s", path)
-        return None
-
-    if not isinstance(data, dict):
-        return None
-
-    install_id = data.get("install_id")
-    last_attempt_at = data.get("last_attempt_at")
-
-    if (
-        not isinstance(install_id, str)
-        or not INSTALL_ID_PATTERN.fullmatch(install_id)
-        or isinstance(last_attempt_at, bool)
-        or not isinstance(last_attempt_at, int | float)
-    ):
-        logger.warning("Ignoring invalid analytics state at %s", path)
-        return None
-
-    return AnalyticsState(install_id=install_id, last_attempt_at=float(last_attempt_at))
-
-
-def save_state(state: AnalyticsState, path: str = STATE_PATH) -> bool:
-    """Write the state atomically, returning False when it can't be written."""
-    temp_path = f"{path}.tmp"
-
-    try:
-        with open(temp_path, "w") as f:
-            json.dump(
-                {
-                    "install_id": state.install_id,
-                    "last_attempt_at": state.last_attempt_at,
-                },
-                f,
-            )
-
-        os.replace(temp_path, path)
-    except OSError:
-        return False
-
-    return True
-
-
-def delete_state(path: str = STATE_PATH) -> None:
-    """Forget the install ID, so a later opt-in starts a fresh identity."""
-    try:
-        os.remove(path)
-    except FileNotFoundError:
-        pass
-    except OSError:
-        logger.warning("Unable to delete analytics state at %s", path)

frigate/analytics/transport.py

@@ -1,54 +0,0 @@
-"""POST a report to the ingest endpoint."""
-
-import logging
-from enum import Enum
-
-import requests
-
-from frigate.version import VERSION
-
-logger = logging.getLogger(__name__)
-
-TIMEOUT_S = 30
-
-
-class SendOutcome(Enum):
-    accepted = "accepted"
-    rejected = "rejected"
-    rate_limited = "rate_limited"
-    failed = "failed"
-
-
-def send_report(url: str, body: str) -> SendOutcome:
-    """Send one report. Never raises; the outcome says what happened."""
-    try:
-        # a redirect would turn the POST into a GET, so it counts as a failure
-        response = requests.post(
-            url,
-            data=body.encode(),
-            headers={
-                "Content-Type": "application/json",
-                "User-Agent": f"Frigate/{VERSION}",
-            },
-            timeout=TIMEOUT_S,
-            allow_redirects=False,
-        )
-    except requests.RequestException as err:
-        logger.warning("Unable to send the analytics report: %s", err)
-        return SendOutcome.failed
-
-    status = response.status_code
-
-    if 200 <= status < 300:
-        return SendOutcome.accepted
-
-    if status == 400:
-        logger.warning("The analytics report was rejected: %s", response.text[:200])
-        return SendOutcome.rejected
-
-    if status == 429:
-        logger.debug("The analytics endpoint is rate limiting this install")
-        return SendOutcome.rate_limited
-
-    logger.warning("The analytics endpoint returned %s", status)
-    return SendOutcome.failed

frigate/api/analytics.py

@@ -1,25 +0,0 @@
-"""Analytics APIs."""
-
-import logging
-
-from fastapi import APIRouter, Depends, Request
-from fastapi.responses import JSONResponse
-
-from frigate.analytics.report import preview_report
-from frigate.api.auth import require_role
-from frigate.api.defs.tags import Tags
-
-logger = logging.getLogger(__name__)
-
-router = APIRouter(tags=[Tags.analytics])
-
-
-@router.get("/analytics/preview", dependencies=[Depends(require_role(["admin"]))])
-def get_analytics_preview(request: Request) -> JSONResponse:
-    """Get the analytics report Frigate would send next, without sending it."""
-    report = preview_report(
-        request.app.frigate_config,
-        request.app.stats_emitter,
-        request.app.notice_registry,
-    )
-    return JSONResponse(content=report.model_dump(mode="json"))

frigate/api/app.py

@@ -63,6 +63,7 @@ from frigate.util.builtin import (
     flatten_config_data,
     load_labels,
     process_config_query_string,
+    split_config_key_path,
     update_yaml_file_bulk,
 )
 from frigate.util.config import (
@@ -70,6 +71,10 @@ from frigate.util.config import (
     find_config_file,
     redact_credential,
 )
+from frigate.util.live_streams import (
+    generated_transcode_streams,
+    sync_transcode_streams,
+)
 from frigate.util.object_names import get_categorized_object_names
 from frigate.util.schema import get_config_schema
 from frigate.util.services import (
@@ -429,6 +434,8 @@ def ffmpeg_presets():
         hwaccel_presets = [
             "preset-rpi-64-h264",
             "preset-rpi-64-h265",
+            "preset-apple-silicon-h264",
+            "preset-apple-silicon-h265",
             "preset-jetson-h264",
             "preset-jetson-h265",
             "preset-rkmpp",
@@ -808,6 +815,17 @@ def _config_set_in_memory(request: Request, body: AppConfigSetBody) -> JSONRespo
         )
 
 
+def _config_path_exists(data: Any, key_path: str) -> bool:
+    """Return whether a dotted config path is present in parsed yaml."""
+    for key in split_config_key_path(key_path):
+        if not isinstance(data, dict) or key not in data:
+            return False
+
+        data = data[key]
+
+    return True
+
+
 @router.put("/config/set", dependencies=[Depends(require_role(["admin"]))])
 def config_set(request: Request, body: AppConfigSetBody):
     config_file = find_config_file()
@@ -862,6 +880,19 @@ def config_set(request: Request, body: AppConfigSetBody):
                         status_code=400,
                     )
 
+                # delete replaced paths first so their maps are rewritten in
+                # the order sent; update_yaml would otherwise keep old order
+                if body.replace_paths:
+                    old_yaml = ruamel.yaml.YAML(typ="safe").load(old_raw_config) or {}
+                    updates = {
+                        **{
+                            path: ""
+                            for path in body.replace_paths
+                            if _config_path_exists(old_yaml, path)
+                        },
+                        **updates,
+                    }
+
                 # apply all updates in a single operation
                 update_yaml_file_bulk(config_file, updates)
 
@@ -925,9 +956,15 @@ def config_set(request: Request, body: AppConfigSetBody):
             if request.app.dispatcher is not None:
                 request.app.dispatcher.clear_runtime_state_for_yaml_keys(updates.keys())
 
+            go2rtc_synced = True
+
             if body.requires_restart == 0 or body.update_topic:
                 old_config: FrigateConfig = request.app.frigate_config
                 swap_runtime_config(request.app, config)
+                go2rtc_synced = sync_transcode_streams(
+                    generated_transcode_streams(old_config),
+                    generated_transcode_streams(config),
+                )
 
                 if body.update_topic:
                     if body.update_topic.startswith("config/cameras/"):
@@ -987,6 +1024,7 @@ def config_set(request: Request, body: AppConfigSetBody):
                             if body.requires_restart == 0
                             else "Config successfully updated, restart to apply"
                         ),
+                        "go2rtc_synced": go2rtc_synced,
                     }
                 ),
                 status_code=200,

frigate/api/camera.py

@@ -39,6 +39,11 @@ from frigate.util.builtin import clean_camera_user_pass, get_record_segment_time
 from frigate.util.camera_cleanup import cleanup_camera_db, cleanup_camera_files
 from frigate.util.config import find_config_file
 from frigate.util.image import run_ffmpeg_snapshot
+from frigate.util.live_streams import (
+    generated_transcode_streams,
+    measure_stream_bitrate,
+    sync_transcode_streams,
+)
 from frigate.util.services import (
     analyze_record_keyframes,
     ffprobe_stream,
@@ -248,6 +253,34 @@ def go2rtc_delete_stream(stream_name: str):
         )
 
 
+@router.get(
+    "/go2rtc/streams/{stream_name}/bitrate",
+    dependencies=[Depends(require_role(["admin"]))],
+)
+async def go2rtc_stream_bitrate(request: Request, stream_name: str):
+    """Measure a go2rtc stream's bitrate over a few seconds."""
+    config: FrigateConfig = request.app.frigate_config
+    known = set(config.go2rtc.model_dump().get("streams") or {}) | set(
+        generated_transcode_streams(config)
+    )
+
+    if stream_name not in known:
+        return JSONResponse(
+            content={"success": False, "message": "Unknown stream"},
+            status_code=404,
+        )
+
+    kbps = await asyncio.to_thread(measure_stream_bitrate, stream_name)
+
+    if kbps is None:
+        return JSONResponse(
+            content={"success": False, "message": "Stream sent no data"},
+            status_code=502,
+        )
+
+    return JSONResponse(content={"success": True, "kbps": round(kbps)})
+
+
 @router.get("/ffprobe", dependencies=[Depends(require_role(["admin"]))])
 def ffprobe(request: Request, paths: str = "", detailed: bool = False):
     path_param = paths
@@ -1342,6 +1375,12 @@ async def delete_camera(
     except Exception:
         logger.debug("Failed to remove go2rtc stream for %s", camera_name)
 
+    await asyncio.to_thread(
+        sync_transcode_streams,
+        generated_transcode_streams(frigate_config),
+        generated_transcode_streams(request.app.frigate_config),
+    )
+
     return JSONResponse(
         content={
             "success": True,

frigate/api/defs/request/app_body.py

@@ -10,6 +10,8 @@ class AppConfigSetBody(BaseModel):
     update_topic: str | None = None
     config_data: dict[str, Any] | None = None
     skip_save: bool = False
+    # paths rewritten whole, so a map saves in the order sent
+    replace_paths: list[str] = Field(default_factory=list)
 
 
 class GenAIProbeBody(BaseModel):

frigate/api/defs/tags.py

@@ -2,7 +2,6 @@ from enum import Enum
 
 
 class Tags(Enum):
-    analytics = "Analytics"
     app = "App"
     auth = "Auth"
     camera = "Camera"

frigate/api/fastapi_app.py

@@ -12,8 +12,8 @@ from slowapi.middleware import SlowAPIMiddleware
 from starlette_context import middleware, plugins
 from starlette_context.plugins import Plugin
 
+from frigate.api import app as main_app
 from frigate.api import (
-    analytics,
     auth,
     camera,
     chat,
@@ -30,7 +30,6 @@ from frigate.api import (
     record,
     review,
 )
-from frigate.api import app as main_app
 from frigate.api.auth import get_jwt_secret, limiter, require_admin_by_default
 from frigate.comms.dispatcher import Dispatcher
 from frigate.comms.event_metadata_updater import (
@@ -141,7 +140,6 @@ def create_fastapi_app(
 
     # Routes
     # Order of include_router matters: https://fastapi.tiangolo.com/tutorial/path-params/#order-matters
-    app.include_router(analytics.router)
     app.include_router(auth.router)
     app.include_router(camera.router)
     app.include_router(chat.router)

frigate/api/notices.py

@@ -14,17 +14,18 @@ router = APIRouter(tags=[Tags.notices])
 
 
 @router.get("/notices", dependencies=[Depends(require_role(["admin"]))])
-def get_notices(request: Request, include_dismissed: bool = False) -> JSONResponse:
+def get_notices(request: Request, include_hidden: bool = False) -> JSONResponse:
     """Get notices, most severe first.
 
     Args:
-        include_dismissed: Also return dismissed notices, for the history view
+        include_hidden: Also return acknowledged and muted notices, for the
+            hidden list
 
     Returns:
         The notices
     """
     return JSONResponse(
-        content=request.app.notice_registry.active(include_dismissed=include_dismissed)
+        content=request.app.notice_registry.active(include_hidden=include_hidden)
     )
 
 
@@ -34,37 +35,64 @@ def get_notice_stats(request: Request) -> JSONResponse:
     return JSONResponse(content=request.app.notice_registry.stats())
 
 
-@router.get(
+@router.get("/notices/muted_checks", dependencies=[Depends(require_role(["admin"]))])
-    "/notices/dismissed_checks", dependencies=[Depends(require_role(["admin"]))]
+def get_muted_checks(request: Request) -> JSONResponse:
-)
+    """Get the muted config and stream check rows, newest first."""
-def get_dismissed_checks(request: Request) -> JSONResponse:
+    return JSONResponse(content=request.app.notice_registry.muted_checks())
-    """Get the dismissed config and stream check rows, newest first."""
-    return JSONResponse(content=request.app.notice_registry.dismissed_checks())
 
 
-@router.delete("/notices/dismissed", dependencies=[Depends(require_role(["admin"]))])
+@router.delete("/notices/hidden", dependencies=[Depends(require_role(["admin"]))])
-def purge_dismissed(request: Request) -> JSONResponse:
+def unhide_all_notices(request: Request) -> JSONResponse:
-    """Delete every dismissed notice and check row so each can show again."""
+    """Show every acknowledged and muted notice and check row again."""
-    request.app.notice_registry.purge_dismissed()
+    request.app.notice_registry.unhide_all()
-    return JSONResponse(
+    return JSONResponse(content={"success": True, "message": "Notices shown again"})
-        content={"success": True, "message": "Dismissed notices cleared"}
-    )
 
 
 # model notice ids contain a slash, so the id is a path parameter
 @router.post(
-    "/notices/{notice_id:path}/dismiss",
+    "/notices/{notice_id:path}/acknowledge",
     dependencies=[Depends(require_role(["admin"]))],
 )
-def dismiss_notice(request: Request, notice_id: str) -> JSONResponse:
+def acknowledge_notice(request: Request, notice_id: str) -> JSONResponse:
-    """Hide a notice or a config or stream check row.
+    """Hide a notice until it happens again.
 
-    It stays hidden if the same problem happens again.
+    Config and stream check rows and the update notice never repeat, so they
+    can only be muted.
     """
-    if not request.app.notice_registry.dismiss(notice_id):
+    if not request.app.notice_registry.acknowledge(notice_id):
         return JSONResponse(
             content={"success": False, "message": "Notice not found"},
             status_code=404,
         )
 
-    return JSONResponse(content={"success": True, "message": "Notice dismissed"})
+    return JSONResponse(content={"success": True, "message": "Notice acknowledged"})
+
+
+@router.post(
+    "/notices/{notice_id:path}/mute",
+    dependencies=[Depends(require_role(["admin"]))],
+)
+def mute_notice(request: Request, notice_id: str) -> JSONResponse:
+    """Hide a notice or a config or stream check row for good."""
+    if not request.app.notice_registry.mute(notice_id):
+        return JSONResponse(
+            content={"success": False, "message": "Notice not found"},
+            status_code=404,
+        )
+
+    return JSONResponse(content={"success": True, "message": "Notice muted"})
+
+
+@router.delete(
+    "/notices/{notice_id:path}/hidden",
+    dependencies=[Depends(require_role(["admin"]))],
+)
+def unhide_notice(request: Request, notice_id: str) -> JSONResponse:
+    """Show an acknowledged or muted notice or check row again."""
+    if not request.app.notice_registry.unhide(notice_id):
+        return JSONResponse(
+            content={"success": False, "message": "Notice not found"},
+            status_code=404,
+        )
+
+    return JSONResponse(content={"success": True, "message": "Notice shown again"})

frigate/app.py

@@ -15,7 +15,6 @@ import uvicorn
 from peewee_migrate import Router
 from playhouse.sqlite_ext import SqliteExtDatabase
 
-from frigate.analytics.reporter import AnalyticsReporter
 from frigate.api.auth import hash_password
 from frigate.api.fastapi_app import create_fastapi_app
 from frigate.camera import CameraMetrics, PTZMetrics
@@ -530,15 +529,6 @@ class FrigateApp:
         )
         self.stats_emitter.start()
 
-    def start_analytics_reporter(self) -> None:
-        self.analytics_reporter = AnalyticsReporter(
-            self.config_holder,
-            self.stats_emitter,
-            self.notice_registry,
-            self.stop_event,
-        )
-        self.analytics_reporter.start()
-
     def start_watchdog(self) -> None:
         self.frigate_watchdog = FrigateWatchdog(self.detectors, self.stop_event)
 
@@ -690,7 +680,6 @@ class FrigateApp:
         self.start_audio_processor()
         self.start_storage_maintainer()
         self.start_stats_emitter()
-        self.start_analytics_reporter()
         self.start_timeline_processor()
         self.start_event_processor()
         self.start_event_cleanup()
@@ -790,8 +779,6 @@ class FrigateApp:
         self.event_cleanup.join()
         self.record_cleanup.join()
         self.stats_emitter.join()
-        # a send in flight can hold the thread for the whole request timeout
-        self.analytics_reporter.join(timeout=5)
         self.frigate_watchdog.join()
         self.camera_maintainer.join()
         self.db.stop()

frigate/config/camera/live.py

@@ -1,8 +1,57 @@
-from pydantic import Field
+from pydantic import Field, field_validator
+
+from frigate.util.live_streams import DEFAULT_TRANSCODE_QUALITIES
 
 from ..base import FrigateBaseModel
 
-__all__ = ["CameraLiveConfig"]
+__all__ = ["CameraLiveConfig", "LiveTranscodeConfig", "LiveTranscodeQualityConfig"]
+
+
+class LiveTranscodeQualityConfig(FrigateBaseModel):
+    height: int = Field(
+        ge=144,
+        le=2160,
+        title="Height",
+        description="Output height in pixels; width follows the source aspect ratio.",
+    )
+    bitrate: int = Field(
+        ge=64,
+        title="Bitrate",
+        description="Target and maximum video bitrate in kbps.",
+    )
+
+
+class LiveTranscodeConfig(FrigateBaseModel):
+    enabled: bool = Field(
+        default=False,
+        title="Enable transcoded streams",
+        description="Add lower-quality live streams that go2rtc transcodes in real time while someone is watching.",
+    )
+    source: str | None = Field(
+        default=None,
+        title="Source stream",
+        description="go2rtc stream to transcode. Defaults to the first live stream.",
+    )
+    qualities: list[LiveTranscodeQualityConfig] = Field(
+        default_factory=lambda: [
+            LiveTranscodeQualityConfig(**quality)
+            for quality in DEFAULT_TRANSCODE_QUALITIES
+        ],
+        title="Qualities",
+        description="One transcoded stream is added per quality.",
+    )
+
+    @field_validator("qualities")
+    @classmethod
+    def validate_unique_heights(
+        cls, qualities: list[LiveTranscodeQualityConfig]
+    ) -> list[LiveTranscodeQualityConfig]:
+        heights = [quality.height for quality in qualities]
+
+        if len(heights) != len(set(heights)):
+            raise ValueError("Transcoded stream heights must be unique.")
+
+        return qualities
 
 
 class CameraLiveConfig(FrigateBaseModel):
@@ -11,6 +60,11 @@ class CameraLiveConfig(FrigateBaseModel):
         title="Live stream names",
         description="Mapping of configured stream names to restream/go2rtc names used for live playback.",
     )
+    transcode: LiveTranscodeConfig = Field(
+        default_factory=LiveTranscodeConfig,
+        title="Transcoded streams",
+        description="Lower-quality live streams transcoded on demand by go2rtc.",
+    )
     height: int = Field(
         default=720,
         title="Live height",

frigate/config/config.py

@@ -35,6 +35,12 @@ from frigate.util.config import (
     migrate_frigate_config,
 )
 from frigate.util.image import create_mask
+from frigate.util.live_streams import (
+    default_transcode_source,
+    is_transcode_stream_name,
+    transcode_stream_name,
+    transcode_streams,
+)
 from frigate.util.services import auto_detect_hwaccel
 
 from .auth import AuthConfig
@@ -282,11 +288,78 @@ def verify_config_roles(camera_config: CameraConfig) -> None:
         )
 
 
+def apply_live_transcode_streams(
+    frigate_config: FrigateConfig, camera_config: CameraConfig
+) -> None:
+    """Fold a camera's transcoded streams into its live stream list.
+
+    Enabled qualities missing from live.streams are appended, and entries the
+    user placed keep their position. Transcoded names that are no longer
+    generated are dropped unless they name a real go2rtc stream.
+    """
+    live = camera_config.live
+    transcode = live.transcode
+    go2rtc_streams = frigate_config.go2rtc.model_dump().get("streams") or {}
+    generated: dict[str, str] = {}
+
+    if transcode.enabled:
+        if transcode.source is None:
+            transcode.source = default_transcode_source(
+                camera_config.name, live.streams
+            )
+
+        if transcode.source not in go2rtc_streams:
+            raise ValueError(
+                f"Camera {camera_config.name} has transcoded streams enabled, but its source {transcode.source} is not a go2rtc stream."
+            )
+
+        generated = transcode_streams(
+            camera_config.name,
+            transcode.source,
+            [quality.model_dump() for quality in transcode.qualities],
+        )
+
+        for name in generated:
+            if name in go2rtc_streams:
+                raise ValueError(
+                    f"Camera {camera_config.name} generates transcoded stream {name}, which collides with a go2rtc stream of the same name."
+                )
+
+    streams = {
+        label: name
+        for label, name in live.streams.items()
+        if name in generated
+        or name in go2rtc_streams
+        or not is_transcode_stream_name(camera_config.name, name)
+    }
+    placed = set(streams.values())
+
+    for quality in transcode.qualities if transcode.enabled else []:
+        name = transcode_stream_name(camera_config.name, quality.height)
+
+        if name in placed:
+            continue
+
+        label = f"{quality.height}p"
+
+        if label in streams:
+            raise ValueError(
+                f"Camera {camera_config.name} already has a live stream named {label}; rename it or place the transcoded stream under another name."
+            )
+
+        streams[label] = name
+
+    live.streams = streams
+
+
 def verify_valid_live_stream_names(
     frigate_config: FrigateConfig, camera_config: CameraConfig
 ) -> ValueError | None:
     """Verify that a restream exists to use for live view."""
     for _, stream_name in camera_config.live.streams.items():
+        if is_transcode_stream_name(camera_config.name, stream_name):
+            continue
+
         if (
             stream_name
             not in frigate_config.go2rtc.model_dump().get("streams", {}).keys()
@@ -978,6 +1051,8 @@ class FrigateConfig(FrigateBaseModel):
                 "face_recognition": ["enabled", "min_area"],
                 "lpr": ["enabled", "expire_time", "min_area", "enhancement"],
                 "audio_transcription": ["enabled", "live_enabled"],
+                # transcode is camera-level only
+                "live": ["streams", "height", "quality"],
             }
 
             for section in allowed_fields_map:
@@ -1206,6 +1281,8 @@ class FrigateConfig(FrigateBaseModel):
             if not camera_config.live.streams:
                 camera_config.live.streams = {name: name}
 
+            apply_live_transcode_streams(self, camera_config)
+
             # generate the ffmpeg commands
             camera_config.create_ffmpeg_cmds()
             self.cameras[name] = camera_config

frigate/config/holder.py

@@ -1,14 +1,9 @@
 """Shared handle on the config object that is current for this instance."""
 
-import logging
-from collections.abc import Callable
-
 from .config import FrigateConfig
 
 __all__ = ["ConfigHolder"]
 
-logger = logging.getLogger(__name__)
-
 
 class ConfigHolder:
     """Indirection for the most recently parsed config.
@@ -28,24 +23,12 @@ class ConfigHolder:
 
     def __init__(self, config: FrigateConfig) -> None:
         self._config = config
-        self._listeners: list[Callable[[FrigateConfig], None]] = []
 
     @property
     def config(self) -> FrigateConfig:
         """The config as of the most recent successful save."""
         return self._config
 
-    def subscribe(self, listener: Callable[[FrigateConfig], None]) -> None:
-        """Call listener on the saving thread with each config installed later."""
-        self._listeners.append(listener)
-
     def set(self, config: FrigateConfig) -> None:
         """Install a freshly parsed config as the current one."""
         self._config = config
-
-        for listener in self._listeners:
-            try:
-                listener(config)
-            except Exception:
-                # a listener bug must not fail the save that has already applied
-                logger.exception("Config listener failed")

frigate/config/telemetry.py

@@ -29,11 +29,6 @@ class StatsConfig(FrigateBaseModel):
 
 
 class TelemetryConfig(FrigateBaseModel):
-    analytics: bool = Field(
-        default=False,
-        title="Share anonymous analytics",
-        description="Send one anonymous usage report a day to help the Frigate maintainers decide what to support. Nothing is sent until this is on.",
-    )
     network_interfaces: list[str] = Field(
         default=[],
         title="Network interfaces",

frigate/const.py

@@ -101,9 +101,6 @@ MAX_WAL_SIZE = 10  # MB
 
 DEFAULT_FFMPEG_VERSION = os.environ.get("DEFAULT_FFMPEG_VERSION", "")
 INCLUDED_FFMPEG_VERSIONS = os.environ.get("INCLUDED_FFMPEG_VERSIONS", "").split(":")
-ANALYTICS_URL = os.environ.get(
-    "FRIGATE_ANALYTICS_URL", "https://analytics.frigate.video/report"
-)
 LIBAVFORMAT_VERSION_MAJOR = int(os.environ.get("LIBAVFORMAT_VERSION_MAJOR", "59"))
 FFMPEG_HWACCEL_NVIDIA = "preset-nvidia"
 FFMPEG_HWACCEL_VAAPI = "preset-vaapi"

frigate/detectors/detection_runners.py

@@ -46,8 +46,42 @@ _PROVIDER_LABELS = {
     "MIGraphXExecutionProvider": "MIGraphX",
     "OpenVINOExecutionProvider": "OpenVINO",
     "CPUExecutionProvider": "CPU",
+    "LighterANE": "Neural Engine",
 }
 
+# lighter (https://github.com/fieldwork-ai/lighter) places an ONNX Runtime plugin
+# execution provider in a container started with --device lighter.sh/ane=all,
+# which runs models on a Mac's Neural Engine; LIGHTER_ANE_EP names where it is
+LIGHTER_ANE_EP_NAME = "LighterANE"
+LIGHTER_ANE_LIBRARY = "/usr/lib/lighter/liblighter_ane_ep.so"
+
+
+def get_lighter_ane_devices() -> list[Any]:
+    """Get the Neural Engine devices lighter's provider offers, registering it once.
+
+    Returns:
+        The provider's ONNX Runtime devices, or an empty list without lighter's device
+    """
+    library = os.environ.get("LIGHTER_ANE_EP", LIGHTER_ANE_LIBRARY)
+
+    if not os.path.exists(library):
+        return []
+
+    devices = [d for d in ort.get_ep_devices() if d.ep_name == LIGHTER_ANE_EP_NAME]
+
+    if not devices:
+        try:
+            ort.register_execution_provider_library(LIGHTER_ANE_EP_NAME, library)
+        except Exception as e:
+            logger.warning(
+                f"Failed to load the Neural Engine provider from {library}: {e}"
+            )
+            return []
+
+        devices = [d for d in ort.get_ep_devices() if d.ep_name == LIGHTER_ANE_EP_NAME]
+
+    return devices
+
 
 def is_arm64_platform() -> bool:
     """Check if we're running on an ARM platform."""
@@ -689,6 +723,23 @@ def get_optimized_runner(
         if rknn_path:
             return _record_runner(model_path, model_type, RKNNModelRunner(rknn_path))
 
+    if device != "CPU" and (ane_devices := get_lighter_ane_devices()):
+        sess_options = get_ort_session_options(model_type) or ort.SessionOptions()
+        sess_options.add_provider_for_devices(ane_devices, {})
+
+        try:
+            session = ort.InferenceSession(model_path, sess_options=sess_options)
+        except Exception as e:
+            logger.warning(
+                f"Failed to load {model_path} on the Neural Engine, using the default providers: {e}"
+            )
+        else:
+            return _record_runner(
+                model_path,
+                model_type,
+                ONNXModelRunner(session, model_type=model_type),
+            )
+
     providers, options = get_ort_providers(device == "CPU", device, **kwargs)
 
     if providers[0] == "CPUExecutionProvider":

frigate/detectors/hardware.py

@@ -25,6 +25,7 @@ SYS_ROOT = "/sys"
 DEV_ROOT = "/dev"
 PROC_ROOT = "/proc"
 ETC_ROOT = "/etc"
+LIB_ROOT = "/usr/lib"
 
 # a Coral reports as Global Unichip until its firmware is loaded, then as Google
 CORAL_USB_IDS = {("1a6e", "089a"), ("18d1", "9302")}
@@ -317,6 +318,19 @@ def detect_synaptics() -> DetectionHardware | None:
     return _hardware("synaptics", "synaptics", "Synaptics NPU", units)
 
 
+def detect_lighter_ane() -> DetectionHardware | None:
+    """Find a Mac's Neural Engine by the provider library lighter's device places."""
+    library = os.environ.get(
+        "LIGHTER_ANE_EP", f"{LIB_ROOT}/lighter/liblighter_ane_ep.so"
+    )
+    if not os.path.exists(library):
+        return None
+
+    # runs through onnx, whose session picks lighter's provider when it is present
+    units = [HardwareUnit(device="onnx", label="Neural Engine")]
+    return _hardware("onnx:lighter", "onnx", "Apple Neural Engine", units)
+
+
 def detect_cpu() -> DetectionHardware:
     """The CPU, which is always available."""
     units = [HardwareUnit(device="cpu", label="CPU")]
@@ -338,6 +352,7 @@ PROBES = (
     detect_rockchip,
     detect_axengine,
     detect_synaptics,
+    detect_lighter_ane,
     detect_cpu,
 )
 

frigate/detectors/plugins/zmq_ipc.py

@@ -1,7 +1,7 @@
 import json
 import logging
 import os
-from typing import Any, Literal
+from typing import Any, ClassVar, Literal
 
 import numpy as np
 import zmq
@@ -21,6 +21,7 @@ class ZmqDetectorConfig(BaseDetectorConfig):
     model_config = ConfigDict(
         title="ZMQ IPC",
     )
+    device_spec_field: ClassVar[str] = "endpoint"
 
     type: Literal[DETECTOR_KEY]
     endpoint: str = Field(

frigate/ffmpeg_presets.py

@@ -84,6 +84,8 @@ _user_agent_args = [
 PRESETS_HW_ACCEL_DECODE = {
     "preset-rpi-64-h264": "-c:v:1 h264_v4l2m2m",
     "preset-rpi-64-h265": "-c:v:1 hevc_v4l2m2m",
+    "preset-apple-silicon-h264": "-c:v h264_v4l2m2m",
+    "preset-apple-silicon-h265": "-c:v hevc_v4l2m2m",
     FFMPEG_HWACCEL_VAAPI: "-hwaccel_flags allow_profile_mismatch -hwaccel vaapi -hwaccel_device {3} -hwaccel_output_format vaapi",
     "preset-intel-qsv-h264": f"-hwaccel qsv -qsv_device {{3}} -hwaccel_output_format qsv -c:v h264_qsv{' -bsf:v dump_extra' if LIBAVFORMAT_VERSION_MAJOR >= 61 else ''}",  # https://trac.ffmpeg.org/ticket/9766#comment:17
     "preset-intel-qsv-h265": f"-load_plugin hevc_hw -hwaccel qsv -qsv_device {{3}} -hwaccel_output_format qsv{' -bsf:v dump_extra' if LIBAVFORMAT_VERSION_MAJOR >= 61 else ''}",  # https://trac.ffmpeg.org/ticket/9766#comment:17
@@ -120,6 +122,9 @@ PRESETS_HW_ACCEL_DECODE["preset-rk-h265"] = PRESETS_HW_ACCEL_DECODE[
 PRESETS_HW_ACCEL_SCALE = {
     "preset-rpi-64-h264": "-r {0} -vf fps={0},scale={1}:{2}",
     "preset-rpi-64-h265": "-r {0} -vf fps={0},scale={1}:{2}",
+    # ffmpeg's v4l2m2m decoders cannot scale, so frames are scaled on the CPU
+    "preset-apple-silicon-h264": "-r {0} -vf fps={0},scale={1}:{2}",
+    "preset-apple-silicon-h265": "-r {0} -vf fps={0},scale={1}:{2}",
     FFMPEG_HWACCEL_VAAPI: "-r {0} -vf fps={0},scale_vaapi=w={1}:h={2},hwdownload,format=nv12",
     "preset-intel-qsv-h264": "-r {0} -vf vpp_qsv=w={1}:h={2}:format=nv12,hwdownload,format=nv12,fps={0},format=yuv420p",
     "preset-intel-qsv-h265": "-r {0} -vf vpp_qsv=w={1}:h={2}:format=nv12,hwdownload,format=nv12,fps={0},format=yuv420p",
@@ -150,6 +155,8 @@ PRESETS_HW_ACCEL_SCALE["preset-rk-h265"] = PRESETS_HW_ACCEL_SCALE[FFMPEG_HWACCEL
 PRESETS_HW_ACCEL_ENCODE_BIRDSEYE = {
     "preset-rpi-64-h264": "{0} -hide_banner {1} -c:v h264_v4l2m2m {2}",
     "preset-rpi-64-h265": "{0} -hide_banner {1} -c:v hevc_v4l2m2m {2}",
+    "preset-apple-silicon-h264": "{0} -hide_banner {1} -c:v h264_v4l2m2m {2}",
+    "preset-apple-silicon-h265": "{0} -hide_banner {1} -c:v h264_v4l2m2m {2}",
     # -vaapi_device is required in addition to -hwaccel_device: this is the only
     # birdseye preset that uses hwupload, and ffmpeg 8 initializes filters before
     # the decoder creates a device, so hwupload cannot see an -hwaccel_device one.
@@ -184,6 +191,8 @@ PRESETS_HW_ACCEL_ENCODE_BIRDSEYE["preset-rk-h264"] = PRESETS_HW_ACCEL_ENCODE_BIR
 PRESETS_HW_ACCEL_ENCODE_TIMELAPSE = {
     "preset-rpi-64-h264": "{0} -hide_banner {1} -c:v h264_v4l2m2m -pix_fmt yuv420p {2}",
     "preset-rpi-64-h265": "{0} -hide_banner {1} -c:v hevc_v4l2m2m -pix_fmt yuv420p {2}",
+    "preset-apple-silicon-h264": "{0} -hide_banner {1} -c:v h264_v4l2m2m -pix_fmt yuv420p {2}",
+    "preset-apple-silicon-h265": "{0} -hide_banner {1} -c:v hevc_v4l2m2m -pix_fmt yuv420p {2}",
     FFMPEG_HWACCEL_VAAPI: "{0} -hide_banner -hwaccel vaapi -hwaccel_output_format vaapi -hwaccel_device {3} {1} -c:v h264_vaapi {2}",
     "preset-intel-qsv-h264": "{0} -hide_banner {1} -c:v h264_qsv -profile:v high -level:v 4.1 -async_depth:v 1 {2}",
     "preset-intel-qsv-h265": "{0} -hide_banner {1} -c:v hevc_qsv -profile:v main -level:v 4.1 -async_depth:v 1 {2}",

frigate/models.py

@@ -195,15 +195,20 @@ class Notice(Model):
     first_seen = DateTimeField()
     last_seen = DateTimeField()
     count = IntegerField(default=1)
-    dismissed_at = DateTimeField(null=True)
+    # hidden until the next occurrence
+    acknowledged_at = DateTimeField(null=True)
+    # hidden for good
+    muted_at = DateTimeField(null=True)
 
 
 class NoticeStats(Model):
     kind = CharField(null=False, primary_key=True, max_length=50)
     occurrences = IntegerField(default=0)
-    dismissals = IntegerField(default=0)
+    acknowledgements = IntegerField(default=0)
+    mutes = IntegerField(default=0)
     first_seen = DateTimeField()
     last_seen = DateTimeField()
     # watermarks for a future analytics reporter; unused until then
     reported_occurrences = IntegerField(default=0)
-    reported_dismissals = IntegerField(default=0)
+    reported_acknowledgements = IntegerField(default=0)
+    reported_mutes = IntegerField(default=0)

frigate/notices/registry.py

@@ -5,7 +5,7 @@ import threading
 from collections.abc import Callable
 from dataclasses import dataclass
 from datetime import datetime
-from typing import Any
+from typing import Any, cast
 
 from frigate.const import REPLAY_CAMERA_PREFIX
 from frigate.models import Notice, NoticeStats
@@ -77,9 +77,8 @@ class NoticeRegistry:
     ) -> None:
         """Insert a notice or count another occurrence of it.
 
-        A dismissed notice stays dismissed when it is raised again, unless its
+        Another occurrence shows an acknowledged notice again. A muted notice
-        kind sets reopen_at_count. A kind that should come back after a
+        stays hidden.
-        dismissal gives each episode its own scope.
         """
         definition = NOTICE_KINDS.get(kind)
 
@@ -112,7 +111,6 @@ class NoticeRegistry:
                     first_seen=now,
                     last_seen=now,
                     count=1,
-                    dismissed_at=None,
                 )
                 self._bump_occurrences(kind, 1, now)
 
@@ -175,7 +173,7 @@ class NoticeRegistry:
             self._notify()
 
     def resolve_camera(self, camera: str) -> None:
-        """Drop the notices and check dismissals of a camera being deleted."""
+        """Drop the notices and check mutes of a camera being deleted."""
         camera_kinds = [
             key
             for key, definition in NOTICE_KINDS.items()
@@ -193,7 +191,7 @@ class NoticeRegistry:
             )
 
             # a stream id names its camera first; a config id ends with camera.<name>
-            for check in self.dismissed_checks():
+            for check in self.muted_checks():
                 check_id = check["id"]
 
                 if check_id.startswith(f"stream:{camera}:") or (
@@ -205,26 +203,50 @@ class NoticeRegistry:
         if deleted:
             self._notify()
 
-    def purge_dismissed(self) -> int:
+    def acknowledge(self, row_id: str) -> bool:
-        """Delete every dismissed row so each can show again. Returns how many."""
+        """Hide a notice until it happens again.
-        with self._lock:
-            return int(
-                Notice.delete().where(Notice.dismissed_at.is_null(False)).execute()
-            )
 
-    def dismiss(self, row_id: str) -> bool:
+        Returns False for an unknown id or a kind that never repeats, such as
-        """Hide a notice or check row for good. Returns False for an unknown id."""
+        a check row or the update notice.
+        """
         with self._lock:
             existing = Notice.get_or_none(Notice.id == row_id)
 
             if existing is None:
-                # a check row gets a notice row only once it is dismissed
+                return False
+
+            definition = NOTICE_KINDS.get(existing.kind)
+
+            if definition is None or not definition.counts_repeats:
+                return False
+
+            if existing.acknowledged_at is not None or existing.muted_at is not None:
+                return True
+
+            Notice.update(acknowledged_at=datetime.now().timestamp()).where(
+                Notice.id == row_id
+            ).execute()
+            NoticeStats.update(acknowledgements=NoticeStats.acknowledgements + 1).where(
+                NoticeStats.kind == existing.kind
+            ).execute()
+
+        self._notify()
+        return True
+
+    def mute(self, row_id: str) -> bool:
+        """Hide a notice or check row for good. Returns False for an unknown id."""
+        now = datetime.now().timestamp()
+
+        with self._lock:
+            existing = Notice.get_or_none(Notice.id == row_id)
+
+            if existing is None:
+                # a check row gets a notice row only once it is muted
                 kind, _, scope = row_id.partition(":")
 
                 if kind not in CHECK_KINDS or not scope:
                     return False
 
-                now = datetime.now().timestamp()
                 Notice.create(
                     id=row_id,
                     kind=kind,
@@ -233,40 +255,78 @@ class NoticeRegistry:
                     first_seen=now,
                     last_seen=now,
                     count=1,
-                    dismissed_at=now,
+                    muted_at=now,
                 )
                 return True
 
-            if existing.dismissed_at is not None:
+            if existing.muted_at is not None:
                 return True
 
             if existing.kind not in NOTICE_KINDS:
                 return False
 
-            Notice.update(dismissed_at=datetime.now().timestamp()).where(
+            Notice.update(acknowledged_at=None, muted_at=now).where(
                 Notice.id == row_id
             ).execute()
-            NoticeStats.update(dismissals=NoticeStats.dismissals + 1).where(
+            NoticeStats.update(mutes=NoticeStats.mutes + 1).where(
                 NoticeStats.kind == existing.kind
             ).execute()
 
         self._notify()
         return True
 
-    def dismissed_checks(self) -> list[dict[str, Any]]:
+    def unhide(self, row_id: str) -> bool:
-        """Dismissed config and stream check rows, newest first."""
+        """Show an acknowledged or muted row again. Returns False for an unknown id."""
+        with self._lock:
+            existing = Notice.get_or_none(Notice.id == row_id)
+
+            if existing is None:
+                return False
+
+            if existing.kind in CHECK_KINDS:
+                Notice.delete_by_id(row_id)
+                return True
+
+            Notice.update(acknowledged_at=None, muted_at=None).where(
+                Notice.id == row_id
+            ).execute()
+
+        self._notify()
+        return True
+
+    def unhide_all(self) -> None:
+        """Show every acknowledged and muted row again."""
+        with self._lock:
+            for check in self.muted_checks():
+                Notice.delete_by_id(check["id"])
+
+            shown = (
+                Notice.update(acknowledged_at=None, muted_at=None)
+                .where(
+                    Notice.acknowledged_at.is_null(False)
+                    | Notice.muted_at.is_null(False)
+                )
+                .execute()
+            )
+
+        if shown:
+            self._notify()
+
+    def muted_checks(self) -> list[dict[str, Any]]:
+        """Muted config and stream check rows, newest first."""
         rows = (
             Notice.select()
             .where(Notice.kind.in_(list(CHECK_KINDS)))
-            .order_by(Notice.dismissed_at.desc())
+            .order_by(Notice.muted_at.desc())
         )
-        return [{"id": row.id, "dismissed_at": row.dismissed_at} for row in rows]
+        return [{"id": row.id, "muted_at": row.muted_at} for row in rows]
 
-    def active(self, include_dismissed: bool = False) -> list[dict[str, Any]]:
+    def active(self, include_hidden: bool = False) -> list[dict[str, Any]]:
         """Notices most severe first, then most recent first.
 
         Args:
-            include_dismissed: Also return dismissed notices, for the history view
+            include_hidden: Also return acknowledged and muted notices, for the
+                hidden list
         """
         rows = []
 
@@ -276,7 +336,9 @@ class NoticeRegistry:
             if definition is None:
                 continue
 
-            if row.dismissed_at is not None and not include_dismissed:
+            hidden = row.acknowledged_at is not None or row.muted_at is not None
+
+            if hidden and not include_hidden:
                 continue
 
             rows.append(
@@ -291,7 +353,9 @@ class NoticeRegistry:
                     "first_seen": row.first_seen,
                     "last_seen": row.last_seen,
                     "count": row.count,
-                    "dismissed_at": row.dismissed_at,
+                    "acknowledgeable": definition.counts_repeats,
+                    "acknowledged_at": row.acknowledged_at,
+                    "muted_at": row.muted_at,
                 }
             )
 
@@ -309,29 +373,18 @@ class NoticeRegistry:
             {
                 "kind": row.kind,
                 "occurrences": row.occurrences,
-                "dismissals": row.dismissals,
+                "acknowledgements": row.acknowledgements,
+                "mutes": row.mutes,
                 "first_seen": row.first_seen,
                 "last_seen": row.last_seen,
                 "reported_occurrences": row.reported_occurrences,
-                "reported_dismissals": row.reported_dismissals,
+                "reported_acknowledgements": row.reported_acknowledgements,
+                "reported_mutes": row.reported_mutes,
             }
             for row in NoticeStats.select()
             if row.kind in NOTICE_KINDS
         ]
 
-    def mark_reported(self, snapshot: list[dict[str, Any]]) -> None:
-        """Move the analytics watermarks to the counts a sent report was built from.
-
-        Using the snapshot rather than the current counts sends anything raised
-        while the report was in flight with the next one.
-        """
-        with self._lock:
-            for row in snapshot:
-                NoticeStats.update(
-                    reported_occurrences=row["occurrences"],
-                    reported_dismissals=row["dismissals"],
-                ).where(NoticeStats.kind == row["kind"]).execute()
-
     def _write_repeats(
         self,
         row: Notice,
@@ -340,18 +393,18 @@ class NoticeRegistry:
         last_seen: float,
         params: dict[str, Any],
     ) -> None:
-        # called with the lock held
+        # called with the lock held; held repeats from before an acknowledgement
-        fields: dict[str, Any] = {
+        # still count but leave the notice hidden
-            "count": row.count + count,
+        still_acknowledged = row.acknowledged_at is not None and (
-            "last_seen": last_seen,
+            last_seen <= cast(float, row.acknowledged_at)
-            "params": params,
+        )
-        }
-        reopen_at = NOTICE_KINDS[kind].reopen_at_count
 
-        if reopen_at is not None and row.count < reopen_at <= row.count + count:
+        Notice.update(
-            fields["dismissed_at"] = None
+            count=row.count + count,
-
+            last_seen=last_seen,
-        Notice.update(**fields).where(Notice.id == row.id).execute()
+            params=params,
+            acknowledged_at=row.acknowledged_at if still_acknowledged else None,
+        ).where(Notice.id == row.id).execute()
         self._bump_occurrences(kind, count, last_seen)
 
     def _prune(self, kind: str, keep: int) -> None:
@@ -375,7 +428,8 @@ class NoticeRegistry:
             NoticeStats.create(
                 kind=kind,
                 occurrences=count,
-                dismissals=0,
+                acknowledgements=0,
+                mutes=0,
                 first_seen=now,
                 last_seen=now,
             )

frigate/notices/types.py

@@ -28,9 +28,9 @@ class NoticeKind:
         category: camera, detector, model, or system; a camera scope is a
             camera name, and the UI shows it
         link: app route or absolute URL for the row, filled in from params
-        counts_repeats: whether raising an existing notice counts another occurrence
+        counts_repeats: whether raising an existing notice counts another
+            occurrence, which also shows an acknowledged notice again
         batch_repeats: whether repeats wait in memory for the next flush
-        reopen_at_count: count at which a dismissed notice shows again
         keep_latest: rows of this kind to keep; a new row drops the oldest
         reportable: whether a future analytics reporter may send this kind's counts
     """
@@ -41,7 +41,6 @@ class NoticeKind:
     link: str | None = None
     counts_repeats: bool = True
     batch_repeats: bool = False
-    reopen_at_count: int | None = None
     keep_latest: int | None = None
     reportable: bool = True
 
@@ -67,6 +66,12 @@ _KINDS = (
         "camera",
         link="/system#cameras",
     ),
+    NoticeKind(
+        "ffmpeg_high_cpu", NoticeSeverity.warning, "camera", link="/system#cameras"
+    ),
+    NoticeKind(
+        "detect_high_cpu", NoticeSeverity.warning, "camera", link="/system#cameras"
+    ),
     NoticeKind("shm_too_low", NoticeSeverity.warning, "system", link="/system#storage"),
     # one row per user per burst; the login log lines carry the address
     NoticeKind(
@@ -75,10 +80,9 @@ _KINDS = (
         "system",
         link="/logs",
         batch_repeats=True,
-        reopen_at_count=5,
         keep_latest=100,
     ),
-    # one row per release, so a dismissal lasts until the next release
+    # one row per release, so muting it lasts until the next release
     NoticeKind(
         "update_available",
         NoticeSeverity.info,
@@ -86,23 +90,13 @@ _KINDS = (
         link="https://github.com/blakeblackshear/frigate/releases/tag/v{version}",
         counts_repeats=False,
         keep_latest=1,
-        reportable=False,
-    ),
-    # raised while analytics is off; the row keeps a dismissal across restarts
-    NoticeKind(
-        "analytics_prompt",
-        NoticeSeverity.info,
-        "system",
-        link="/settings?page=systemTelemetry",
-        counts_repeats=False,
-        reportable=False,
     ),
 )
 
 NOTICE_KINDS: dict[str, NoticeKind] = {kind.key: kind for kind in _KINDS}
 
 # the Health tab builds config and stream check rows in the browser, so a notice
-# row of these kinds only records a dismissal; its other fields are placeholders
+# row of these kinds only records a mute; its other fields are placeholders
 CHECK_KINDS = frozenset({"config", "stream"})
 
 

frigate/stats/emitter.py

@@ -29,38 +29,59 @@ VERSION_REFRESH_S = 24 * 60 * 60
 # a camera skipping at least this percent of its frames is falling behind
 SKIPPED_DETECTIONS_PCT = 5
 
-# for at least this long before it becomes a notice
+# lifetime CPU averages at or above these are high; they match
-SKIPPED_DETECTIONS_HOLD_S = 60
+# CameraFfmpegThreshold.error and CameraDetectThreshold.error in the UI
+FFMPEG_HIGH_CPU_PCT = 20
+DETECT_HIGH_CPU_PCT = 40
+
+# a camera stays over a threshold this long before it becomes a notice
+EPISODE_HOLD_S = 60
 
 # detectors warm up after a start; the status bar waits this long too
 STARTUP_GRACE_S = 120
 
 
-class SkippedDetectionsTracker:
+def cpu_average(cpu_usages: dict[str, Any], pid: int | None) -> float | None:
-    """Finds cameras whose skipped share stays high long enough for a notice."""
+    """A process's CPU use averaged over its lifetime, or None if unknown."""
+    usage = cpu_usages.get(str(pid)) if pid else None
 
-    def __init__(self) -> None:
+    try:
+        return float(usage["cpu_average"]) if usage else None
+    except (KeyError, TypeError, ValueError):
+        return None
+
+
+class EpisodeTracker:
+    """Finds cameras whose value stays over a threshold long enough for a notice."""
+
+    def __init__(self, threshold: float) -> None:
+        self._threshold = threshold
         self._since: dict[str, float] = {}
         self._raised: set[str] = set()
 
-    def update(self, cameras: dict[str, dict[str, Any]], now: float) -> list[str]:
+    def update(self, values: dict[str, float | None], now: float) -> list[str]:
-        """Return the cameras whose episode qualified on this sample."""
+        """Return the cameras whose episode qualified on this sample.
+
+        Args:
+            values: Each camera's current value, or None when it has none
+            now: Sample time in seconds
+        """
         qualified: list[str] = []
 
         # a removed camera that comes back starts a new episode
-        for camera in self._since.keys() - cameras.keys():
+        for camera in self._since.keys() - values.keys():
             self._since.pop(camera)
             self._raised.discard(camera)
 
-        for camera, camera_stats in cameras.items():
+        for camera, value in values.items():
-            if camera_stats["skipped_pct"] < SKIPPED_DETECTIONS_PCT:
+            if value is None or value < self._threshold:
                 self._since.pop(camera, None)
                 self._raised.discard(camera)
                 continue
 
             since = self._since.setdefault(camera, now)
 
-            if camera not in self._raised and now - since >= SKIPPED_DETECTIONS_HOLD_S:
+            if camera not in self._raised and now - since >= EPISODE_HOLD_S:
                 self._raised.add(camera)
                 qualified.append(camera)
 
@@ -80,7 +101,9 @@ class StatsEmitter(threading.Thread):
         self.stop_event = stop_event
         self.hardware_stats = HardwareStats(config)
         self.stats_history: list[dict[str, Any]] = []
-        self.skipped_detections = SkippedDetectionsTracker()
+        self.skipped_detections = EpisodeTracker(SKIPPED_DETECTIONS_PCT)
+        self.ffmpeg_cpu = EpisodeTracker(FFMPEG_HIGH_CPU_PCT)
+        self.detect_cpu = EpisodeTracker(DETECT_HIGH_CPU_PCT)
 
         # the shm notice's params as last sent, so only a change is written
         self._shm_checked = False
@@ -227,15 +250,38 @@ class StatsEmitter(threading.Thread):
 
     def _update_notices(self, stats: dict[str, Any], now: float) -> None:
         """Update notices based on current stats or time."""
-        # skipped detections
+        cameras = stats["cameras"]
+
+        # absent when CPU collection timed out or failed on this tick
+        cpu_usages = stats.get("cpu_usages", {})
+
         if stats["service"]["uptime"] >= STARTUP_GRACE_S:
-            for camera in self.skipped_detections.update(stats["cameras"], now):
+            # skipped detections
+            skipped = {
+                camera: camera_stats["skipped_pct"]
+                for camera, camera_stats in cameras.items()
+            }
+
+            for camera in self.skipped_detections.update(skipped, now):
                 raise_notice(
                     "skipped_detections",
                     scope=camera,
-                    params={"pct": stats["cameras"][camera]["skipped_pct"]},
+                    params={"pct": skipped[camera]},
                 )
 
+            # high ffmpeg and detect CPU
+            for tracker, kind, pid_key in (
+                (self.ffmpeg_cpu, "ffmpeg_high_cpu", "ffmpeg_pid"),
+                (self.detect_cpu, "detect_high_cpu", "pid"),
+            ):
+                averages = {
+                    camera: cpu_average(cpu_usages, camera_stats.get(pid_key))
+                    for camera, camera_stats in cameras.items()
+                }
+
+                for camera in tracker.update(averages, now):
+                    raise_notice(kind, scope=camera, params={"cpu": averages[camera]})
+
         # shm too small for the cameras
         self._update_shm_notice(stats["service"]["storage"]["/dev/shm"])
 

frigate/test/analytics_helpers.py

@@ -1,36 +0,0 @@
-"""Shared fixtures for the analytics tests."""
-
-from typing import Any
-
-from frigate.analytics.context import ReportContext
-from frigate.config import FrigateConfig
-
-FRONT_CAMERA: dict[str, Any] = {
-    "ffmpeg": {"inputs": [{"path": "rtsp://10.0.0.1:554/video", "roles": ["detect"]}]},
-    "detect": {"height": 720, "width": 1280, "fps": 5},
-}
-
-
-def make_config(config: dict[str, Any] | None = None) -> FrigateConfig:
-    """A parsed config; top-level keys in config replace the defaults here.
-
-    hwaccel_args is set so parsing never probes the test host's GPU.
-    """
-    base: dict[str, Any] = {
-        "mqtt": {"host": "mqtt"},
-        "ffmpeg": {"hwaccel_args": []},
-        "cameras": {"front": FRONT_CAMERA},
-    }
-    return FrigateConfig(**{**base, **(config or {})})
-
-
-def make_context(
-    config: FrigateConfig | None = None,
-    stats: dict[str, Any] | None = None,
-    notice_stats: list[dict[str, Any]] | None = None,
-) -> ReportContext:
-    return ReportContext(
-        config=config or make_config(),
-        stats=stats or {},
-        notice_stats=notice_stats or [],
-    )

frigate/test/http_api/test_http_analytics.py

@@ -1,49 +0,0 @@
-"""Tests for the analytics preview API."""
-
-from unittest.mock import Mock, patch
-
-from frigate.analytics import report
-from frigate.analytics.collectors import hardware
-from frigate.models import Notice, NoticeStats, User
-from frigate.notices.registry import NoticeRegistry
-from frigate.test.http_api.base_http_test import AuthTestClient, BaseTestHttp
-
-
-class TestHttpAnalytics(BaseTestHttp):
-    def setUp(self):
-        super().setUp([Notice, NoticeStats, User])
-        stats = Mock()
-        stats.get_latest_stats.return_value = self.test_stats
-        self.app = self.create_app(stats=stats, notice_registry=NoticeRegistry())
-
-        for target, name, value in (
-            (report, "load_state", None),
-            (hardware.hardware_prober, "probe", []),
-            (hardware, "hwaccel_options", ("", [])),
-        ):
-            patcher = patch.object(target, name, return_value=value)
-            patcher.start()
-            self.addCleanup(patcher.stop)
-
-    def test_preview_returns_the_report_without_sending_it(self):
-        with (
-            patch("frigate.analytics.transport.requests.post") as post,
-            AuthTestClient(self.app) as client,
-        ):
-            response = client.get("/analytics/preview")
-
-        self.assertEqual(response.status_code, 200)
-        body = response.json()
-        self.assertEqual(body["install_id"], report.PREVIEW_INSTALL_ID)
-        self.assertEqual(body["schema_version"], 1)
-        self.assertEqual(body["cameras"]["total"], 1)
-        post.assert_not_called()
-
-    def test_preview_is_admin_only(self):
-        with AuthTestClient(self.app) as client:
-            response = client.get(
-                "/analytics/preview",
-                headers={"remote-user": "viewer", "remote-role": "viewer"},
-            )
-
-        self.assertEqual(response.status_code, 403)

frigate/test/http_api/test_http_config_set_live.py

@@ -0,0 +1,173 @@
+"""Tests for config_set live stream ordering and go2rtc transcode sync."""
+
+import os
+import tempfile
+from unittest.mock import MagicMock, Mock, patch
+
+import ruamel.yaml
+from fastapi import Request
+
+from frigate.api.auth import get_allowed_cameras_for_filter, get_current_user
+from frigate.api.fastapi_app import create_fastapi_app
+from frigate.config import FrigateConfig
+from frigate.config.camera.updater import CameraConfigUpdatePublisher
+from frigate.models import Event, Recordings, ReviewSegment
+from frigate.test.http_api.base_http_test import AuthTestClient, BaseTestHttp
+from frigate.util.live_streams import transcode_stream_source
+
+STREAMS_PATH = "cameras.front_door.live.streams"
+
+
+class TestConfigSetLiveStreams(BaseTestHttp):
+    def setUp(self):
+        super().setUp(models=[Event, Recordings, ReviewSegment])
+        self.minimal_config["go2rtc"] = {
+            "streams": {
+                "front_main": ["rtsp://10.0.0.1:554/main"],
+                "front_sub": ["rtsp://10.0.0.1:554/sub"],
+            }
+        }
+        self.minimal_config["cameras"]["front_door"]["live"] = {
+            "streams": {"Main": "front_main", "Sub": "front_sub"}
+        }
+
+    def _write_config_file(self) -> str:
+        yaml = ruamel.yaml.YAML()
+        f = tempfile.NamedTemporaryFile(mode="w", suffix=".yml", delete=False)
+        yaml.dump(self.minimal_config, f)
+        f.close()
+        self.addCleanup(os.unlink, f.name)
+        return f.name
+
+    def _read_config_file(self, path: str) -> dict:
+        with open(path) as f:
+            return ruamel.yaml.YAML(typ="safe").load(f)
+
+    def _app(self):
+        publisher = Mock(spec=CameraConfigUpdatePublisher)
+        publisher.publisher = MagicMock()
+        app = create_fastapi_app(
+            FrigateConfig(**self.minimal_config),
+            self.db,
+            None,
+            None,
+            None,
+            None,
+            None,
+            None,
+            publisher,
+            None,
+            enforce_default_admin=False,
+        )
+
+        async def mock_get_current_user(request: Request):
+            return {
+                "username": request.headers.get("remote-user"),
+                "role": request.headers.get("remote-role"),
+            }
+
+        async def mock_get_allowed_cameras_for_filter(request: Request):
+            return ["front_door"]
+
+        app.dependency_overrides[get_current_user] = mock_get_current_user
+        app.dependency_overrides[get_allowed_cameras_for_filter] = (
+            mock_get_allowed_cameras_for_filter
+        )
+        return app
+
+    def _save(self, app, live: dict, replace_paths: list[str] | None = None):
+        body = {
+            "config_data": {"cameras": {"front_door": {"live": live}}},
+            "requires_restart": 0,
+            "update_topic": "config/cameras/front_door/live",
+        }
+
+        if replace_paths is not None:
+            body["replace_paths"] = replace_paths
+
+        with AuthTestClient(app) as client:
+            return client.put("/config/set", json=body)
+
+    @patch("frigate.api.app.find_config_file")
+    def test_replace_paths_saves_map_in_sent_order(self, mock_find_config):
+        path = self._write_config_file()
+        mock_find_config.return_value = path
+
+        resp = self._save(
+            self._app(),
+            {"streams": {"Sub": "front_sub", "Main": "front_main"}},
+            [STREAMS_PATH],
+        )
+
+        self.assertEqual(resp.status_code, 200)
+        streams = self._read_config_file(path)["cameras"]["front_door"]["live"][
+            "streams"
+        ]
+        self.assertEqual(list(streams), ["Sub", "Main"])
+
+    @patch("frigate.api.app.find_config_file")
+    def test_without_replace_paths_order_is_kept(self, mock_find_config):
+        path = self._write_config_file()
+        mock_find_config.return_value = path
+
+        self._save(self._app(), {"streams": {"Sub": "front_sub", "Main": "front_main"}})
+
+        streams = self._read_config_file(path)["cameras"]["front_door"]["live"][
+            "streams"
+        ]
+        self.assertEqual(list(streams), ["Main", "Sub"])
+
+    @patch("frigate.api.app.find_config_file")
+    def test_replace_path_missing_from_yaml_is_skipped(self, mock_find_config):
+        del self.minimal_config["cameras"]["front_door"]["live"]
+        path = self._write_config_file()
+        mock_find_config.return_value = path
+
+        resp = self._save(
+            self._app(), {"streams": {"Main": "front_main"}}, [STREAMS_PATH]
+        )
+
+        self.assertEqual(resp.status_code, 200)
+        self.assertEqual(
+            self._read_config_file(path)["cameras"]["front_door"]["live"]["streams"],
+            {"Main": "front_main"},
+        )
+
+    @patch("frigate.api.app.sync_transcode_streams", return_value=True)
+    @patch("frigate.api.app.find_config_file")
+    def test_enabling_transcode_syncs_go2rtc(self, mock_find_config, mock_sync):
+        path = self._write_config_file()
+        mock_find_config.return_value = path
+
+        resp = self._save(
+            self._app(),
+            {
+                "transcode": {
+                    "enabled": True,
+                    "qualities": [{"height": 480, "bitrate": 500}],
+                }
+            },
+        )
+
+        self.assertEqual(resp.status_code, 200)
+        self.assertTrue(resp.json()["go2rtc_synced"])
+        mock_sync.assert_called_once_with(
+            {},
+            {
+                "front_door_transcode_480p": transcode_stream_source(
+                    "front_main", 480, 500
+                )
+            },
+        )
+
+    @patch("frigate.api.app.sync_transcode_streams", return_value=False)
+    @patch("frigate.api.app.find_config_file")
+    def test_sync_failure_is_reported(self, mock_find_config, mock_sync):
+        path = self._write_config_file()
+        mock_find_config.return_value = path
+
+        resp = self._save(self._app(), {"transcode": {"enabled": True}})
+
+        self.assertEqual(resp.status_code, 200)
+        self.assertTrue(resp.json()["success"])
+        self.assertFalse(resp.json()["go2rtc_synced"])

frigate/test/http_api/test_http_go2rtc_bitrate.py

@@ -0,0 +1,61 @@
+"""Tests for the go2rtc stream bitrate endpoint."""
+
+from unittest.mock import patch
+
+from frigate.test.http_api.base_http_test import AuthTestClient, BaseTestHttp
+
+
+class TestHttpGo2rtcBitrate(BaseTestHttp):
+    def setUp(self):
+        super().setUp([])
+        self.minimal_config["go2rtc"] = {
+            "streams": {"front_main": ["rtsp://10.0.0.1:554/main"]}
+        }
+        self.minimal_config["cameras"]["front_door"]["live"] = {
+            "streams": {"Main": "front_main"},
+            "transcode": {
+                "enabled": True,
+                "qualities": [{"height": 480, "bitrate": 500}],
+            },
+        }
+        self.app = self.create_app()
+
+    @patch("frigate.api.camera.measure_stream_bitrate", return_value=812.4)
+    def test_returns_rounded_kbps(self, mock_measure):
+        with AuthTestClient(self.app) as client:
+            resp = client.get("/go2rtc/streams/front_main/bitrate")
+
+        self.assertEqual(resp.status_code, 200)
+        self.assertEqual(resp.json()["kbps"], 812)
+        mock_measure.assert_called_once_with("front_main")
+
+    @patch("frigate.api.camera.measure_stream_bitrate", return_value=480.0)
+    def test_generated_streams_are_known(self, _):
+        with AuthTestClient(self.app) as client:
+            resp = client.get("/go2rtc/streams/front_door_transcode_480p/bitrate")
+
+        self.assertEqual(resp.status_code, 200)
+
+    @patch("frigate.api.camera.measure_stream_bitrate")
+    def test_unknown_stream_is_404(self, mock_measure):
+        with AuthTestClient(self.app) as client:
+            resp = client.get("/go2rtc/streams/rtsp_somewhere/bitrate")
+
+        self.assertEqual(resp.status_code, 404)
+        mock_measure.assert_not_called()
+
+    @patch("frigate.api.camera.measure_stream_bitrate", return_value=None)
+    def test_no_data_is_502(self, _):
+        with AuthTestClient(self.app) as client:
+            resp = client.get("/go2rtc/streams/front_main/bitrate")
+
+        self.assertEqual(resp.status_code, 502)
+
+    def test_viewer_is_forbidden(self):
+        with AuthTestClient(self.app) as client:
+            resp = client.get(
+                "/go2rtc/streams/front_main/bitrate",
+                headers={"remote-user": "viewer", "remote-role": "viewer"},
+            )
+
+        self.assertEqual(resp.status_code, 403)

frigate/test/http_api/test_http_notices.py

@@ -53,92 +53,108 @@ class TestHttpNotices(BaseTestHttp):
         self.assertEqual(response.json()[0]["kind"], "detector_stuck")
         self.assertEqual(response.json()[0]["occurrences"], 1)
 
-    def test_dismiss_hides_and_history_keeps_it(self):
+    def test_acknowledge_hides_and_the_hidden_list_keeps_it(self):
         self.registry.raise_notice(
             "detector_stuck", scope="ov", params={"detector": "ov"}
         )
 
         with self.client() as client:
-            response = client.post("/notices/detector_stuck:ov/dismiss")
+            response = client.post("/notices/detector_stuck:ov/acknowledge")
             listed = client.get("/notices").json()
-            history = client.get("/notices", params={"include_dismissed": True}).json()
+            hidden = client.get("/notices", params={"include_hidden": True}).json()
 
         self.assertEqual(response.status_code, 200)
         self.assertEqual(listed, [])
-        self.assertEqual([n["id"] for n in history], ["detector_stuck:ov"])
+        self.assertEqual([n["id"] for n in hidden], ["detector_stuck:ov"])
-        self.assertIsNotNone(history[0]["dismissed_at"])
+        self.assertIsNotNone(hidden[0]["acknowledged_at"])
 
-    def test_dismiss_an_id_with_a_slash(self):
+    def test_acknowledging_a_check_is_404(self):
+        with self.client() as client:
+            response = client.post(f"/notices/{CONFIG_CHECK}/acknowledge")
+
+        self.assertEqual(response.status_code, 404)
+
+    def test_mute_an_id_with_a_slash(self):
         self.registry.raise_notice(
             "model_download_failed", scope="yolo/model.onnx", params={}
         )
 
         with self.client() as client:
             response = client.post(
-                "/notices/model_download_failed:yolo/model.onnx/dismiss"
+                "/notices/model_download_failed:yolo/model.onnx/mute"
             )
 
         self.assertEqual(response.status_code, 200)
         self.assertEqual(self.registry.active(), [])
 
-    def test_dismiss_unknown_is_404(self):
+    def test_unknown_ids_are_404(self):
         with self.client() as client:
-            response = client.post("/notices/nope/dismiss")
+            responses = [
+                client.post("/notices/nope/acknowledge"),
+                client.post("/notices/nope/mute"),
+                client.delete("/notices/nope/hidden"),
+            ]
 
-        self.assertEqual(response.status_code, 404)
+        self.assertEqual([r.status_code for r in responses], [404, 404, 404])
 
     def test_requires_admin(self):
+        viewer = {"remote-user": "viewer", "remote-role": "viewer"}
+
         with TestClient(self.app) as client:
-            response = client.get(
+            responses = [
-                "/notices", headers={"remote-user": "viewer", "remote-role": "viewer"}
+                client.get("/notices", headers=viewer),
-            )
+                client.get("/notices/muted_checks", headers=viewer),
+                client.post("/notices/detector_stuck:ov/acknowledge", headers=viewer),
+                client.post("/notices/detector_stuck:ov/mute", headers=viewer),
+                client.delete("/notices/detector_stuck:ov/hidden", headers=viewer),
+                client.delete("/notices/hidden", headers=viewer),
+            ]
 
-        self.assertEqual(response.status_code, 403)
+        self.assertEqual([r.status_code for r in responses], [403] * 6)
 
-    def test_dismissed_checks_are_listed_once(self):
+    def test_muted_checks_are_listed_once(self):
         with self.client() as client:
-            first = client.post(f"/notices/{CONFIG_CHECK}/dismiss")
+            first = client.post(f"/notices/{CONFIG_CHECK}/mute")
-            again = client.post(f"/notices/{CONFIG_CHECK}/dismiss")
+            again = client.post(f"/notices/{CONFIG_CHECK}/mute")
-            listed = client.get("/notices/dismissed_checks").json()
+            listed = client.get("/notices/muted_checks").json()
-            history = client.get("/notices", params={"include_dismissed": True}).json()
+            hidden = client.get("/notices", params={"include_hidden": True}).json()
 
         self.assertEqual(first.status_code, 200)
         self.assertEqual(again.status_code, 200)
         self.assertEqual([check["id"] for check in listed], [CONFIG_CHECK])
-        self.assertIsNotNone(listed[0]["dismissed_at"])
+        self.assertIsNotNone(listed[0]["muted_at"])
         # the Health tab builds the row itself, so it never comes back as a notice
-        self.assertEqual(history, [])
+        self.assertEqual(hidden, [])
 
-    def test_dismissed_checks_require_admin(self):
+    def test_unhide_one_row(self):
-        with TestClient(self.app) as client:
-            response = client.get(
-                "/notices/dismissed_checks",
-                headers={"remote-user": "viewer", "remote-role": "viewer"},
-            )
-
-        self.assertEqual(response.status_code, 403)
-
-    def test_purge_dismissed_clears_notices_and_checks(self):
         self.registry.raise_notice(
             "detector_stuck", scope="ov", params={"detector": "ov"}
         )
-        self.registry.dismiss("detector_stuck:ov")
+        self.registry.mute("detector_stuck:ov")
-        self.registry.dismiss(CONFIG_CHECK)
+        self.registry.mute(CONFIG_CHECK)
 
         with self.client() as client:
-            response = client.delete("/notices/dismissed")
+            notice = client.delete("/notices/detector_stuck:ov/hidden")
-            history = client.get("/notices", params={"include_dismissed": True}).json()
+            check = client.delete(f"/notices/{CONFIG_CHECK}/hidden")
-            checks = client.get("/notices/dismissed_checks").json()
+            listed = client.get("/notices").json()
+            checks = client.get("/notices/muted_checks").json()
 
-        self.assertEqual(response.status_code, 200)
+        self.assertEqual([notice.status_code, check.status_code], [200, 200])
-        self.assertEqual(history, [])
+        self.assertEqual([n["id"] for n in listed], ["detector_stuck:ov"])
         self.assertEqual(checks, [])
 
-    def test_purge_dismissed_requires_admin(self):
+    def test_unhide_all_shows_notices_and_drops_check_mutes(self):
-        with TestClient(self.app) as client:
+        self.registry.raise_notice(
-            response = client.delete(
+            "detector_stuck", scope="ov", params={"detector": "ov"}
-                "/notices/dismissed",
+        )
-                headers={"remote-user": "viewer", "remote-role": "viewer"},
+        self.registry.acknowledge("detector_stuck:ov")
-            )
+        self.registry.mute(CONFIG_CHECK)
 
-        self.assertEqual(response.status_code, 403)
+        with self.client() as client:
+            response = client.delete("/notices/hidden")
+            listed = client.get("/notices").json()
+            checks = client.get("/notices/muted_checks").json()
+
+        self.assertEqual(response.status_code, 200)
+        self.assertEqual([n["id"] for n in listed], ["detector_stuck:ov"])
+        self.assertEqual(checks, [])

frigate/test/test_analytics_collectors_cameras.py

@@ -1,112 +0,0 @@
-"""Tests for the cameras collector."""
-
-import unittest
-
-from frigate.analytics.collectors import cameras
-from frigate.analytics.schema import HeightBucket, HwaccelKey, RetainBucket
-from frigate.test.analytics_helpers import make_config, make_context
-
-MASK = {"coordinates": "0,0,1,0,1,1"}
-
-CONFIG = {
-    "record": {
-        "enabled": True,
-        "continuous": {"days": 3},
-        "alerts": {"retain": {"days": 14}},
-        "detections": {"retain": {"days": 45}},
-    },
-    "cameras": {
-        "front": {
-            "ffmpeg": {
-                "hwaccel_args": "preset-vaapi",
-                "inputs": [
-                    {
-                        "path": "rtsp://127.0.0.1:8554/front_sub",
-                        "roles": ["detect"],
-                        "input_args": "preset-rtsp-restream",
-                    },
-                    {"path": "rtsp://127.0.0.1:8554/front", "roles": ["record"]},
-                ],
-            },
-            "detect": {"enabled": True, "height": 720, "width": 1280, "fps": 5},
-            "zones": {"porch": MASK, "yard": MASK},
-            "motion": {"mask": {"tree": MASK}},
-            "objects": {
-                "mask": {"sign": MASK},
-                "filters": {"person": {"mask": {"bush": MASK}}},
-            },
-            "onvif": {"host": "10.0.0.9"},
-        },
-        "garage": {
-            "enabled": False,
-            "type": "lpr",
-            "ffmpeg": {
-                "hwaccel_args": ["-hwaccel", "vaapi"],
-                "inputs": [
-                    {"path": "rtsp://10.0.0.5/stream", "roles": ["detect", "record"]}
-                ],
-            },
-            "detect": {"height": 2160, "width": 3840, "fps": 15},
-            "record": {"enabled": False},
-        },
-        "_replay_front": {
-            "ffmpeg": {
-                "inputs": [{"path": "rtsp://10.0.0.1/replay", "roles": ["detect"]}]
-            },
-            "detect": {"height": 1080, "width": 1920, "fps": 5},
-        },
-    },
-}
-
-STATS = {
-    "cameras": {
-        "front": {"connection_quality": "excellent"},
-        "garage": {"connection_quality": "offline"},
-        "_replay_front": {"connection_quality": "fair"},
-    }
-}
-
-
-class TestCamerasCollector(unittest.TestCase):
-    def test_aggregates_cameras_and_skips_replays(self):
-        section = cameras.collect(make_context(make_config(CONFIG), STATS))
-
-        self.assertEqual((section.total, section.enabled), (2, 1))
-        self.assertEqual(section.types, {"generic": 1, "lpr": 1})
-        self.assertEqual(section.detect_height, {"720": 1, "ge_2160": 1})
-        self.assertEqual(section.detect_fps, {"le_5": 1, "gt_10": 1})
-        self.assertEqual(section.hwaccel, {"vaapi": 1, "custom": 1})
-        self.assertEqual(section.input_preset, {"rtsp-restream": 1, "rtsp-generic": 1})
-        self.assertEqual(section.go2rtc_restream, 1)
-        self.assertEqual(section.separate_detect_stream, 1)
-        self.assertEqual((section.detect, section.record, section.onvif), (1, 1, 1))
-        self.assertEqual((section.zones, section.cameras_with_zones), (2, 1))
-        self.assertEqual((section.motion_masks, section.object_masks), (1, 2))
-        self.assertEqual(section.connection_quality, {"excellent": 1})
-        self.assertEqual(section.retain_days.continuous, {"1_7": 1})
-        self.assertEqual(section.retain_days.motion, {"0": 1})
-        self.assertEqual(section.retain_days.alerts, {"8_30": 1})
-        self.assertEqual(section.retain_days.detections, {"gt_30": 1})
-
-    def test_buckets(self):
-        self.assertEqual(cameras.height_bucket(360), HeightBucket.le_360)
-        self.assertEqual(cameras.height_bucket(361), HeightBucket.h480)
-        self.assertEqual(cameras.height_bucket(1080), HeightBucket.h1080)
-        self.assertEqual(cameras.height_bucket(1440), HeightBucket.h1440)
-        self.assertEqual(cameras.height_bucket(2160), HeightBucket.ge_2160)
-        self.assertEqual(cameras.retain_bucket(0.5), RetainBucket.d1_7)
-        self.assertEqual(cameras.retain_bucket(0), RetainBucket.zero)
-
-    def test_preset_key(self):
-        self.assertEqual(cameras.preset_key([], HwaccelKey), "none")
-        self.assertEqual(cameras.preset_key("", HwaccelKey), "none")
-        self.assertEqual(cameras.preset_key("preset-bogus", HwaccelKey), "custom")
-        self.assertEqual(cameras.preset_key("-hwaccel vaapi", HwaccelKey), "custom")
-        self.assertEqual(cameras.preset_key("preset-nvidia", HwaccelKey), "nvidia")
-
-    def test_is_restream(self):
-        self.assertTrue(cameras.is_restream("rtsp://127.0.0.1:8554/front"))
-        self.assertTrue(cameras.is_restream("rtsp://localhost:8554/front"))
-        self.assertFalse(cameras.is_restream("rtsp://10.0.0.5:8554/front"))
-        self.assertFalse(cameras.is_restream("rtsp://[bad"))
-        self.assertFalse(cameras.is_restream("rtsp://127.0.0.1:notaport/x"))

frigate/test/test_analytics_collectors_detection.py

@@ -1,61 +0,0 @@
-"""Tests for the detection collector."""
-
-import os
-import tempfile
-import unittest
-from unittest.mock import patch
-
-from frigate.analytics.collectors import detection
-from frigate.analytics.schema import ModelSource
-from frigate.detectors.detector_config import SceneEnum
-from frigate.test.analytics_helpers import make_config, make_context
-
-
-class TestDetectionCollector(unittest.TestCase):
-    def test_reports_each_model_with_its_mean_inference_speed(self):
-        config = make_config({"models": [{"devices": ["cpu", "cpu"]}]})
-        stats = {
-            "detectors": {
-                "cpu": {"inference_speed": 10.0},
-                "cpu#2": {"inference_speed": 20.0},
-            },
-            "detection_fps": 12.346,
-            "skipped_fps": 0,
-        }
-
-        section = detection.collect(make_context(config, stats))
-
-        model = section.models[SceneEnum.all]
-        self.assertEqual(model.detector, "cpu")
-        self.assertEqual(model.devices, 2)
-        self.assertEqual(model.model_type, "ssd")
-        self.assertEqual(model.input, "320x320")
-        self.assertEqual(model.source, ModelSource.default)
-        self.assertEqual(model.inference_ms, 15.0)
-        self.assertEqual(section.detection_fps, 12.35)
-        self.assertEqual(section.skipped_fps, 0.0)
-
-    def test_inference_is_null_before_the_first_stats(self):
-        section = detection.collect(make_context())
-
-        self.assertIsNone(section.models[SceneEnum.all].inference_ms)
-
-    def test_model_source(self):
-        with tempfile.TemporaryDirectory() as cache:
-            plus_model = os.path.join(cache, "abc123")
-            open(f"{plus_model}.json", "w").close()
-
-            with patch.object(detection, "MODEL_CACHE_DIR", cache):
-                self.assertEqual(detection.model_source(plus_model), ModelSource.plus)
-                self.assertEqual(
-                    detection.model_source(os.path.join(cache, "no_info")),
-                    ModelSource.custom,
-                )
-
-        self.assertEqual(detection.model_source(None), ModelSource.default)
-        self.assertEqual(
-            detection.model_source("/cpu_model.tflite"), ModelSource.default
-        )
-        self.assertEqual(
-            detection.model_source("/config/yolo.onnx"), ModelSource.custom
-        )

frigate/test/test_analytics_collectors_features.py

@@ -1,128 +0,0 @@
-"""Tests for the features collector."""
-
-import logging
-import os
-import unittest
-
-from peewee_migrate import Router
-from playhouse.sqlite_ext import SqliteExtDatabase
-from playhouse.sqliteq import SqliteQueueDatabase
-
-from frigate.analytics.collectors import features
-from frigate.analytics.schema import EnrichmentDevice, SemanticSearchModel
-from frigate.models import User
-from frigate.test.analytics_helpers import FRONT_CAMERA, make_config, make_context
-from frigate.test.const import TEST_DB, TEST_DB_CLEANUPS
-
-CONFIG = {
-    "mqtt": {"host": "mqtt", "enabled": True},
-    "genai": {
-        "local": {
-            "provider": "ollama",
-            "model": "llava",
-            "base_url": "http://ollama:11434",
-            "roles": ["descriptions", "embeddings"],
-        }
-    },
-    "semantic_search": {"enabled": True, "model": "local"},
-    "face_recognition": {"enabled": True, "model_size": "large"},
-    "birdseye": {"enabled": True, "modes": ["motion", "alerts"], "restream": True},
-    "proxy": {"header_map": {"user": "x-forwarded-user"}},
-    "camera_groups": {"outside": {"cameras": ["front"], "icon": "LuCar", "order": 0}},
-    "cameras": {
-        "front": {
-            **FRONT_CAMERA,
-            "semantic_search": {
-                "triggers": {
-                    "cat": {
-                        "type": "description",
-                        "data": "a cat",
-                        "threshold": 0.8,
-                        "actions": ["notification"],
-                    }
-                }
-            },
-        }
-    },
-}
-
-
-class TestFeaturesCollector(unittest.TestCase):
-    def setUp(self):
-        migrate_db = SqliteExtDatabase(TEST_DB)
-        del logging.getLogger("peewee_migrate").handlers[:]
-        Router(migrate_db).run()
-        migrate_db.close()
-        self.db = SqliteQueueDatabase(TEST_DB)
-        self.db.bind([User])
-
-    def tearDown(self):
-        # close() leaves the queue's writer thread running against the deleted file
-        self.db.stop()
-
-        if not self.db.is_closed():
-            self.db.close()
-
-        for file in TEST_DB_CLEANUPS:
-            try:
-                os.remove(file)
-            except OSError:
-                pass
-
-    def test_collects_enrichments_genai_integrations_and_users(self):
-        for username, role in (("a", "admin"), ("v", "viewer"), ("o", "operator")):
-            User.create(
-                username=username, role=role, password_hash="x", notification_tokens=[]
-            )
-
-        stats = {
-            "embeddings": {
-                "devices": {
-                    "face_recognition": "OpenVINO GPU.0",
-                    "semantic_search": "CUDA",
-                }
-            }
-        }
-
-        section = features.collect(make_context(make_config(CONFIG), stats))
-
-        self.assertEqual(section.face_recognition.device, EnrichmentDevice.openvino_gpu)
-        self.assertEqual(section.face_recognition.model_size, "large")
-        self.assertIsNone(section.lpr.device)
-        self.assertEqual(section.semantic_search.model, SemanticSearchModel.genai)
-        self.assertEqual(section.semantic_search.device, EnrichmentDevice.cuda)
-        self.assertEqual(section.semantic_search.triggers, 1)
-        self.assertEqual(section.genai.providers, {"ollama": 1})
-        self.assertEqual(section.genai.roles, {"descriptions": 1, "embeddings": 1})
-        self.assertEqual(section.birdseye.modes, ["motion", "alerts"])
-        self.assertTrue(section.mqtt)
-        self.assertTrue(section.proxy_auth)
-        self.assertEqual(section.users, {"admin": 1, "viewer": 1, "custom": 1})
-        self.assertEqual((section.camera_groups, section.profiles), (1, 0))
-        self.assertFalse(section.plus_api_key)
-
-
-class TestFeatureMappings(unittest.TestCase):
-    def test_enrichment_device_labels(self):
-        cases = {
-            "CPU": EnrichmentDevice.cpu,
-            "MIGraphX": EnrichmentDevice.migraphx,
-            "OpenVINO NPU": EnrichmentDevice.openvino_npu,
-            "OpenVINO GPU.0,CPU": EnrichmentDevice.openvino_gpu,
-            "OpenVINO": EnrichmentDevice.other,
-            "CoreML": EnrichmentDevice.other,
-        }
-
-        for label, device in cases.items():
-            with self.subTest(label=label):
-                self.assertEqual(features.enrichment_device(label), device)
-
-        self.assertIsNone(features.enrichment_device(None))
-
-    def test_models_named_after_a_provider_are_genai(self):
-        self.assertEqual(features.semantic_model("jinav2"), SemanticSearchModel.jinav2)
-        self.assertEqual(
-            features.semantic_model("my-ollama"), SemanticSearchModel.genai
-        )
-        self.assertIsNone(features.semantic_model(None))
-        self.assertEqual(features.transcription_model("openai"), "genai")

frigate/test/test_analytics_collectors_health.py

@@ -1,65 +0,0 @@
-"""Tests for the health collector."""
-
-import unittest
-
-from frigate.analytics.collectors import health
-from frigate.test.analytics_helpers import make_context
-
-
-class TestHealthCollector(unittest.TestCase):
-    def test_collects_uptime_cpu_timings_and_notice_deltas(self):
-        stats = {
-            "service": {"uptime": 7300, "retention_unmet": True},
-            "cpu_usages": {"frigate.full_system": {"cpu": "23.6", "mem": "40"}},
-            "embeddings": {
-                "face_recognition_speed": 41.234,
-                "text_embedding_speed": 0,
-                "devices": {},
-            },
-        }
-        notice_stats = [
-            {
-                "kind": "detector_stuck",
-                "occurrences": 5,
-                "dismissals": 1,
-                "reported_occurrences": 3,
-                "reported_dismissals": 1,
-            },
-            {
-                "kind": "shm_too_low",
-                "occurrences": 2,
-                "dismissals": 0,
-                "reported_occurrences": 2,
-                "reported_dismissals": 0,
-            },
-            {
-                "kind": "update_available",
-                "occurrences": 4,
-                "dismissals": 0,
-                "reported_occurrences": 0,
-                "reported_dismissals": 0,
-            },
-        ]
-
-        section = health.collect(make_context(stats=stats, notice_stats=notice_stats))
-
-        self.assertEqual(section.uptime_hours, 2)
-        self.assertEqual(section.cpu_percent, 24)
-        self.assertEqual(section.enrichment_ms, {"face": 41.23})
-        self.assertTrue(section.retention_unmet)
-        self.assertEqual(
-            {
-                kind: (c.occurrences, c.dismissals)
-                for kind, c in section.notices.items()
-            },
-            {"detector_stuck": (2, 0)},
-        )
-
-    def test_missing_stats_give_zeros(self):
-        section = health.collect(make_context())
-
-        self.assertEqual(
-            (section.uptime_hours, section.cpu_percent, section.enrichment_ms),
-            (0, 0, {}),
-        )
-        self.assertEqual(section.notices, {})

frigate/test/test_analytics_collectors_system.py

@@ -1,188 +0,0 @@
-"""Tests for the install and hardware collectors."""
-
-import os
-import tempfile
-import unittest
-from collections import Counter
-from types import SimpleNamespace
-from unittest.mock import patch
-
-from frigate.analytics.collectors import hardware, install
-from frigate.analytics.collectors.common import closed, histogram, rate
-from frigate.analytics.schema import (
-    Arch,
-    DecodeFamily,
-    GpuVendor,
-    HardwareKey,
-    ImageVariant,
-    InstallType,
-)
-from frigate.const import RECORD_DIR
-from frigate.test.analytics_helpers import make_context
-
-
-class TestCommon(unittest.TestCase):
-    def test_closed_falls_back_for_unknown_values(self):
-        self.assertEqual(closed(Arch, "x86_64", Arch.other), Arch.x86_64)
-        self.assertEqual(closed(Arch, "sparc", Arch.other), Arch.other)
-        self.assertEqual(closed(Arch, None, Arch.other), Arch.other)
-
-    def test_rate_rounds_and_rejects_bad_numbers(self):
-        self.assertEqual(rate("12.346"), 12.35)
-        self.assertEqual(rate(-3), 0.0)
-        self.assertEqual(rate(float("nan")), 0.0)
-        self.assertEqual(rate(float("inf")), 0.0)
-        self.assertEqual(rate(None), 0.0)
-
-    def test_histogram_drops_empty_buckets(self):
-        self.assertEqual(
-            histogram(Counter({Arch.x86_64: 2, Arch.other: 0})), {"x86_64": 2}
-        )
-
-
-class TestInstallCollector(unittest.TestCase):
-    def test_collects_version_variant_and_platform(self):
-        with (
-            patch.dict(os.environ, {"FRIGATE_IMAGE_VARIANT": "tensorrt-jp6"}),
-            patch.object(install, "install_type", return_value=InstallType.docker),
-            patch("platform.machine", return_value="aarch64"),
-            patch("platform.release", return_value="6.8.0-45-generic"),
-            patch("os.geteuid", return_value=1000),
-        ):
-            section = install.collect(make_context())
-
-        self.assertEqual(section.image_variant, ImageVariant.tensorrt_jp6)
-        self.assertEqual(section.install_type, InstallType.docker)
-        self.assertEqual(section.arch, Arch.aarch64)
-        self.assertEqual(section.kernel, "6.8")
-        self.assertFalse(section.run_as_root)
-
-    def test_image_variant_is_dev_when_unset_and_other_when_unknown(self):
-        self.assertEqual(install.image_variant(None), ImageVariant.dev)
-        self.assertEqual(install.image_variant(""), ImageVariant.dev)
-        self.assertEqual(install.image_variant("h8l"), ImageVariant.other)
-
-    def test_install_type_checks_the_add_on_first(self):
-        with patch("os.path.isfile", return_value=True):
-            self.assertEqual(install.install_type(), InstallType.ha_addon)
-
-        with (
-            patch("os.path.isfile", return_value=False),
-            patch.dict(os.environ, {"KUBERNETES_SERVICE_HOST": "10.0.0.1"}),
-        ):
-            self.assertEqual(install.install_type(), InstallType.kubernetes)
-
-        env = {k: v for k, v in os.environ.items() if k != "KUBERNETES_SERVICE_HOST"}
-
-        with (
-            patch("os.path.isfile", return_value=False),
-            patch.dict(os.environ, env, clear=True),
-            patch("os.path.exists", side_effect=lambda path: path == "/.dockerenv"),
-        ):
-            self.assertEqual(install.install_type(), InstallType.docker)
-
-    def test_kernel_and_arch_fall_back(self):
-        self.assertEqual(install.kernel("weird"), "unknown")
-        self.assertEqual(install.arch("armv7l"), Arch.other)
-        self.assertEqual(install.arch("amd64"), Arch.x86_64)
-
-
-class TestHardwareCollector(unittest.TestCase):
-    def setUp(self):
-        self.dir = tempfile.TemporaryDirectory()
-        self.addCleanup(self.dir.cleanup)
-
-    def write(self, name: str, content: str) -> str:
-        path = os.path.join(self.dir.name, name)
-
-        with open(path, "w") as f:
-            f.write(content)
-
-        return path
-
-    def test_cpu_model_prefers_the_board_model(self):
-        board = self.write("model", "Raspberry Pi 5 Model B Rev 1.0\x00")
-        cpuinfo = self.write("cpuinfo", "model name\t: Cortex-A76\n")
-
-        with (
-            patch.object(hardware, "DEVICE_TREE_MODEL", board),
-            patch.object(hardware, "CPUINFO", cpuinfo),
-        ):
-            self.assertEqual(hardware.cpu_model(), "Raspberry Pi 5 Model B Rev 1.0")
-
-    def test_cpu_model_reads_cpuinfo_and_truncates(self):
-        cpuinfo = self.write("cpuinfo", "processor\t: 0\nmodel name\t: " + "x" * 80)
-
-        with (
-            patch.object(hardware, "DEVICE_TREE_MODEL", self.dir.name + "/none"),
-            patch.object(hardware, "CPUINFO", cpuinfo),
-        ):
-            self.assertEqual(hardware.cpu_model(), "x" * 64)
-
-    def test_collects_gpus_decode_detection_and_storage(self):
-        stats = {
-            "gpu_usages": {
-                "NVIDIA GeForce RTX 3060": {"vendor": "nvidia"},
-                "mystery": {},
-            },
-            "service": {
-                "storage": {
-                    RECORD_DIR: {
-                        "total": 2048000.0,
-                        "used": 512000.0,
-                        "mount_type": "nfs4",
-                    }
-                }
-            },
-        }
-        probed = [
-            SimpleNamespace(key="edgetpu:usb", count=2),
-            SimpleNamespace(key="new:thing", count=1),
-            SimpleNamespace(key="cpu", count=1),
-        ]
-        families = [
-            SimpleNamespace(key="vaapi"),
-            SimpleNamespace(key="intel-qsv"),
-            SimpleNamespace(key="future"),
-        ]
-
-        with (
-            patch.object(hardware.hardware_prober, "probe", return_value=probed),
-            patch.object(hardware, "hwaccel_options", return_value=("vaapi", families)),
-            patch.object(hardware, "cpu_model", return_value="Intel(R) N100"),
-            patch("os.cpu_count", return_value=4),
-            patch(
-                "psutil.virtual_memory", return_value=SimpleNamespace(total=16 * 2**30)
-            ),
-        ):
-            section = hardware.collect(make_context(stats=stats))
-
-        self.assertEqual(section.cpu_model, "Intel(R) N100")
-        self.assertEqual(section.cpu_cores, 4)
-        self.assertEqual(section.memory_gb, 16)
-        self.assertEqual(
-            [(gpu.vendor, gpu.name) for gpu in section.gpus],
-            [
-                (GpuVendor.nvidia, "NVIDIA GeForce RTX 3060"),
-                (GpuVendor.other, "mystery"),
-            ],
-        )
-        self.assertEqual(
-            section.decode_families,
-            [DecodeFamily.vaapi, DecodeFamily.intel_qsv, DecodeFamily.other],
-        )
-        self.assertEqual(
-            section.detection_hardware,
-            {HardwareKey.edgetpu_usb: 2, HardwareKey.other: 1, HardwareKey.cpu: 1},
-        )
-        self.assertEqual(section.storage.record_fs, "nfs4")
-        self.assertEqual(section.storage.record_total_gb, 2000)
-        self.assertEqual(section.storage.record_used_pct, 25)
-
-    def test_storage_without_stats_is_unknown_and_empty(self):
-        section = hardware.storage({})
-
-        self.assertEqual(
-            (section.record_fs, section.record_total_gb, section.record_used_pct),
-            ("unknown", 0, 0),
-        )

frigate/test/test_analytics_report.py

@@ -1,107 +0,0 @@
-"""Tests for building a report from the collectors."""
-
-import json
-import logging
-import os
-import unittest
-from unittest.mock import Mock, patch
-
-from peewee_migrate import Router
-from playhouse.sqlite_ext import SqliteExtDatabase
-from playhouse.sqliteq import SqliteQueueDatabase
-
-from frigate.analytics import report
-from frigate.analytics.collectors import hardware
-from frigate.analytics.schema import AnalyticsReport, InstallSection
-from frigate.models import User
-from frigate.test.analytics_helpers import make_context
-from frigate.test.const import TEST_DB, TEST_DB_CLEANUPS
-
-INSTALL = InstallSection(
-    version="0.19.0",
-    image_variant="dev",
-    install_type="docker",
-    arch="x86_64",
-    kernel="6.8",
-    run_as_root=False,
-)
-
-
-class TestBuildReport(unittest.TestCase):
-    def test_a_failing_collector_nulls_only_its_section(self):
-        collectors = {
-            "install": lambda ctx: INSTALL,
-            "hardware": Mock(side_effect=RuntimeError("boom")),
-            "detection": lambda ctx: None,
-            "cameras": lambda ctx: None,
-            "features": lambda ctx: None,
-            "health": lambda ctx: None,
-        }
-
-        with patch.dict(report.COLLECTORS, collectors):
-            built = report.build_report(make_context(), "a" * 32, sent_at=1790000000)
-
-        self.assertEqual(built.install, INSTALL)
-        self.assertIsNone(built.hardware)
-        self.assertEqual(built.schema_version, 1)
-        self.assertEqual(built.sent_at, 1790000000)
-        self.assertRegex(built.report_id, r"^[0-9a-f-]{36}$")
-
-
-class TestRealCollectors(unittest.TestCase):
-    def setUp(self):
-        migrate_db = SqliteExtDatabase(TEST_DB)
-        del logging.getLogger("peewee_migrate").handlers[:]
-        Router(migrate_db).run()
-        migrate_db.close()
-        self.db = SqliteQueueDatabase(TEST_DB)
-        self.db.bind([User])
-
-    def tearDown(self):
-        # close() leaves the queue's writer thread running against the deleted file
-        self.db.stop()
-
-        if not self.db.is_closed():
-            self.db.close()
-
-        for file in TEST_DB_CLEANUPS:
-            try:
-                os.remove(file)
-            except OSError:
-                pass
-
-    def test_every_section_builds_and_round_trips_through_json(self):
-        with (
-            patch.object(hardware.hardware_prober, "probe", return_value=[]),
-            patch.object(hardware, "hwaccel_options", return_value=("", [])),
-        ):
-            built = report.build_report(make_context(), "a" * 32)
-
-        body = built.model_dump_json()
-        parsed = json.loads(body)
-
-        for section in (
-            "install",
-            "hardware",
-            "detection",
-            "cameras",
-            "features",
-            "health",
-        ):
-            with self.subTest(section=section):
-                self.assertIsNotNone(parsed[section])
-
-        self.assertEqual(AnalyticsReport.model_validate_json(body), built)
-
-    def test_preview_uses_a_placeholder_id_before_the_first_report(self):
-        stats_emitter = Mock()
-        stats_emitter.get_latest_stats.return_value = {}
-
-        with (
-            patch.object(report, "load_state", return_value=None),
-            patch.object(hardware.hardware_prober, "probe", return_value=[]),
-            patch.object(hardware, "hwaccel_options", return_value=("", [])),
-        ):
-            built = report.preview_report(make_context().config, stats_emitter, None)
-
-        self.assertEqual(built.install_id, report.PREVIEW_INSTALL_ID)

frigate/test/test_analytics_reporter.py

@@ -1,227 +0,0 @@
-"""Tests for the analytics reporter's schedule and consent handling."""
-
-import os
-import tempfile
-import threading
-import unittest
-from unittest.mock import Mock, patch
-
-from frigate.analytics import reporter as reporter_module
-from frigate.analytics.reporter import (
-    FIRST_DELAY_S,
-    INTERVAL_S,
-    JITTER_S,
-    PROMPT_KIND,
-    WAKE_S,
-    AnalyticsReporter,
-)
-from frigate.analytics.state import AnalyticsState, load_state, save_state
-from frigate.analytics.transport import SendOutcome
-from frigate.config.holder import ConfigHolder
-from frigate.test.analytics_helpers import make_config
-
-SNAPSHOT = [
-    {
-        "kind": "detector_stuck",
-        "occurrences": 3,
-        "dismissals": 0,
-        "reported_occurrences": 1,
-        "reported_dismissals": 0,
-    }
-]
-
-
-class TestAnalyticsReporter(unittest.TestCase):
-    def setUp(self):
-        self.dir = tempfile.TemporaryDirectory()
-        self.addCleanup(self.dir.cleanup)
-        self.path = os.path.join(self.dir.name, ".analytics.json")
-        self.now = 1_790_000_000.0
-        self.send = Mock(return_value=SendOutcome.accepted)
-        self.registry = Mock()
-        self.registry.stats.return_value = SNAPSHOT
-        self.stats = Mock()
-        self.stats.get_latest_stats.return_value = {}
-        self.holder = ConfigHolder(make_config({"telemetry": {"analytics": True}}))
-
-        for name in ("raise_notice", "resolve_notice"):
-            patcher = patch.object(reporter_module, name)
-            setattr(self, name, patcher.start())
-            self.addCleanup(patcher.stop)
-
-        self.built = Mock()
-        self.built.model_dump_json.return_value = '{"report": 1}'
-        patcher = patch.object(reporter_module, "build_report", return_value=self.built)
-        self.build_report = patcher.start()
-        self.addCleanup(patcher.stop)
-
-    def reporter(self, path: str | None = None) -> AnalyticsReporter:
-        # uniform(a, b) returns a: the shortest startup delay and interval
-        rng = Mock()
-        rng.uniform.side_effect = lambda low, high: low
-
-        return AnalyticsReporter(
-            self.holder,
-            self.stats,
-            self.registry,
-            threading.Event(),
-            state_path=path or self.path,
-            url="https://example.test/report",
-            send=self.send,
-            clock=lambda: self.now,
-            rng=rng,
-        )
-
-    def advance(self, seconds: float) -> None:
-        self.now += seconds
-
-    def test_waits_for_the_startup_delay_then_sends(self):
-        reporter = self.reporter()
-
-        reporter.tick()
-        self.send.assert_not_called()
-
-        self.advance(FIRST_DELAY_S[0])
-        reporter.tick()
-
-        self.send.assert_called_once_with(
-            "https://example.test/report", '{"report": 1}'
-        )
-        self.registry.mark_reported.assert_called_once_with(SNAPSHOT)
-        self.assertEqual(load_state(self.path).last_attempt_at, self.now)
-
-    def test_sends_once_per_interval(self):
-        reporter = self.reporter()
-        self.advance(FIRST_DELAY_S[0])
-        reporter.tick()
-
-        self.advance(WAKE_S)
-        reporter.tick()
-        self.assertEqual(self.send.call_count, 1)
-
-        self.advance(INTERVAL_S - JITTER_S)
-        reporter.tick()
-        self.assertEqual(self.send.call_count, 2)
-
-    def test_a_restart_inside_the_interval_does_not_send(self):
-        save_state(AnalyticsState("a" * 32, self.now), self.path)
-        reporter = self.reporter()
-
-        self.advance(FIRST_DELAY_S[0])
-        reporter.tick()
-
-        self.send.assert_not_called()
-
-    def test_a_failed_send_keeps_watermarks_and_waits_a_full_interval(self):
-        self.send.return_value = SendOutcome.failed
-        reporter = self.reporter()
-        self.advance(FIRST_DELAY_S[0])
-
-        reporter.tick()
-        self.advance(WAKE_S)
-        reporter.tick()
-
-        self.assertEqual(self.send.call_count, 1)
-        self.registry.mark_reported.assert_not_called()
-
-    def test_an_accepted_report_without_health_keeps_the_watermarks(self):
-        self.built.health = None
-        reporter = self.reporter()
-        self.advance(FIRST_DELAY_S[0])
-
-        reporter.tick()
-
-        self.send.assert_called_once()
-        self.registry.mark_reported.assert_not_called()
-
-    def test_consent_withdrawn_while_the_report_builds_stops_the_send(self):
-        reporter = self.reporter()
-        self.advance(FIRST_DELAY_S[0])
-
-        def withdraw(*args, **kwargs):
-            self.holder.set(make_config())
-            return self.built
-
-        self.build_report.side_effect = withdraw
-        reporter.tick()
-
-        self.send.assert_not_called()
-        self.assertFalse(os.path.exists(self.path))
-
-    def test_turning_sharing_off_and_on_between_wakes_starts_a_fresh_identity(self):
-        save_state(AnalyticsState("a" * 32, 0.0), self.path)
-        reporter = self.reporter()
-        reporter.tick()
-
-        self.holder.set(make_config())
-        self.holder.set(make_config({"telemetry": {"analytics": True}}))
-        self.advance(FIRST_DELAY_S[0])
-        reporter.tick()
-
-        self.raise_notice.assert_called_once_with(PROMPT_KIND)
-        self.assertNotEqual(load_state(self.path).install_id, "a" * 32)
-
-    def test_opting_out_raises_the_prompt_once_and_deletes_the_state(self):
-        self.holder.set(make_config())
-        save_state(AnalyticsState("a" * 32, 0.0), self.path)
-        reporter = self.reporter()
-
-        reporter.tick()
-        reporter.tick()
-
-        self.raise_notice.assert_called_once_with(PROMPT_KIND)
-        self.assertFalse(os.path.exists(self.path))
-        self.send.assert_not_called()
-
-    def test_opting_in_resolves_the_prompt(self):
-        self.holder.set(make_config())
-        reporter = self.reporter()
-        reporter.tick()
-
-        self.holder.set(make_config({"telemetry": {"analytics": True}}))
-        reporter.tick()
-
-        self.resolve_notice.assert_called_once_with(PROMPT_KIND)
-
-    def test_safe_mode_touches_nothing(self):
-        self.holder.set(make_config({"safe_mode": True}))
-        save_state(AnalyticsState("a" * 32, 0.0), self.path)
-        reporter = self.reporter()
-
-        self.advance(FIRST_DELAY_S[0])
-        reporter.tick()
-
-        self.raise_notice.assert_not_called()
-        self.assertTrue(os.path.exists(self.path))
-        self.send.assert_not_called()
-
-    def test_an_unwritable_config_dir_skips_sending_and_warns_once(self):
-        reporter = self.reporter(os.path.join(self.dir.name, "missing", "x.json"))
-        self.advance(FIRST_DELAY_S[0])
-
-        with self.assertLogs("frigate.analytics.reporter", "WARNING") as logs:
-            reporter.tick()
-            self.advance(WAKE_S)
-            reporter.tick()
-
-        self.send.assert_not_called()
-        self.assertEqual(len(logs.output), 1)
-
-    def test_a_last_attempt_in_the_future_is_ignored(self):
-        save_state(AnalyticsState("a" * 32, self.now + 10 * INTERVAL_S), self.path)
-        reporter = self.reporter()
-
-        self.advance(FIRST_DELAY_S[0])
-        reporter.tick()
-
-        self.send.assert_called_once()
-
-    def test_the_loop_survives_a_failing_tick(self):
-        reporter = self.reporter()
-        reporter.stop_event.set()
-
-        with (
-            patch.object(reporter, "tick", side_effect=RuntimeError("boom")),
-            self.assertLogs("frigate.analytics.reporter", "ERROR"),
-        ):
-            reporter.run()

frigate/test/test_analytics_schema.py

@@ -1,137 +0,0 @@
-"""Tests for the analytics report schema."""
-
-import inspect
-import re
-import unittest
-from enum import Enum
-from typing import Any, get_args, get_origin
-
-from pydantic import BaseModel
-
-import frigate.detectors.hardware as detection_hardware
-import frigate.util.hwaccel as hwaccel
-from frigate.analytics.schema import (
-    AnalyticsReport,
-    DecodeFamily,
-    HardwareKey,
-    HwaccelKey,
-    InputPresetKey,
-    NoticeKindKey,
-)
-from frigate.ffmpeg_presets import PRESETS_HW_ACCEL_DECODE, PRESETS_INPUT
-from frigate.notices.types import NOTICE_KINDS
-from frigate.util.hwaccel import HwaccelFamily
-
-# the only str fields: generated ids and strings the hardware reports
-ALLOWED_STRINGS = {
-    ("AnalyticsReport", "install_id"),
-    ("AnalyticsReport", "report_id"),
-    ("InstallSection", "version"),
-    ("InstallSection", "kernel"),
-    ("HardwareSection", "cpu_model"),
-    ("GpuInfo", "name"),
-    ("StorageInfo", "record_fs"),
-    ("DetectionModel", "input"),
-}
-
-
-def nested_models(annotation: Any) -> list[type[BaseModel]]:
-    if isinstance(annotation, type) and issubclass(annotation, BaseModel):
-        return [annotation]
-
-    return [model for arg in get_args(annotation) for model in nested_models(arg)]
-
-
-def all_models(
-    model: type[BaseModel], seen: set[type[BaseModel]] | None = None
-) -> list[type[BaseModel]]:
-    seen = set() if seen is None else seen
-
-    if model in seen:
-        return []
-
-    seen.add(model)
-    found = [model]
-
-    for field in model.model_fields.values():
-        for nested in nested_models(field.annotation):
-            found += all_models(nested, seen)
-
-    return found
-
-
-def dict_key_types(annotation: Any) -> list[Any]:
-    keys = [get_args(annotation)[0]] if get_origin(annotation) is dict else []
-    return keys + [key for arg in get_args(annotation) for key in dict_key_types(arg)]
-
-
-class TestSchemaDiscipline(unittest.TestCase):
-    def test_every_field_has_a_description_and_public_flag(self):
-        for model in all_models(AnalyticsReport):
-            for name, field in model.model_fields.items():
-                with self.subTest(field=f"{model.__name__}.{name}"):
-                    self.assertTrue(field.description)
-                    self.assertIsInstance(field.json_schema_extra, dict)
-                    self.assertIsInstance(field.json_schema_extra.get("x-public"), bool)
-
-    def test_strings_are_limited_to_ids_and_hardware_names(self):
-        for model in all_models(AnalyticsReport):
-            properties = model.model_json_schema()["properties"]
-
-            for name, field in model.model_fields.items():
-                if field.annotation is not str:
-                    continue
-
-                with self.subTest(field=f"{model.__name__}.{name}"):
-                    self.assertIn((model.__name__, name), ALLOWED_STRINGS)
-                    self.assertTrue(
-                        "maxLength" in properties[name] or "pattern" in properties[name]
-                    )
-
-    def test_map_keys_are_enums(self):
-        for model in all_models(AnalyticsReport):
-            for name, field in model.model_fields.items():
-                for key_type in dict_key_types(field.annotation):
-                    with self.subTest(field=f"{model.__name__}.{name}"):
-                        self.assertTrue(issubclass(key_type, Enum))
-
-
-class TestEnumsTrackTheirSources(unittest.TestCase):
-    def test_hardware_keys_cover_every_probe(self):
-        probed = set(
-            re.findall(
-                r'_hardware\(\s*"([^"]+)"', inspect.getsource(detection_hardware)
-            )
-        )
-
-        self.assertTrue(probed)
-        self.assertLessEqual(probed, {key.value for key in HardwareKey})
-
-    def test_decode_families_cover_every_hwaccel_family(self):
-        families = {
-            value.key
-            for value in vars(hwaccel).values()
-            if isinstance(value, HwaccelFamily)
-        }
-
-        self.assertTrue(families)
-        self.assertLessEqual(families, {family.value for family in DecodeFamily})
-
-    def test_preset_keys_mirror_the_presets(self):
-        for enum, presets in (
-            (HwaccelKey, PRESETS_HW_ACCEL_DECODE),
-            (InputPresetKey, PRESETS_INPUT),
-        ):
-            with self.subTest(enum=enum.__name__):
-                self.assertEqual(
-                    {key.value for key in enum},
-                    {name.removeprefix("preset-") for name in presets}
-                    | {"custom", "none"},
-                )
-
-    def test_notice_keys_are_the_reportable_kinds(self):
-        self.assertEqual(
-            {key.value for key in NoticeKindKey},
-            {key for key, kind in NOTICE_KINDS.items() if kind.reportable},
-        )
-        self.assertNotIn("analytics_prompt", {key.value for key in NoticeKindKey})

frigate/test/test_analytics_state.py

@@ -1,64 +0,0 @@
-"""Tests for the analytics state file."""
-
-import os
-import tempfile
-import unittest
-
-from frigate.analytics.state import (
-    AnalyticsState,
-    delete_state,
-    load_state,
-    new_state,
-    save_state,
-)
-
-
-class TestAnalyticsState(unittest.TestCase):
-    def setUp(self):
-        self.dir = tempfile.TemporaryDirectory()
-        self.addCleanup(self.dir.cleanup)
-        self.path = os.path.join(self.dir.name, ".analytics.json")
-
-    def write(self, content: str) -> None:
-        with open(self.path, "w") as f:
-            f.write(content)
-
-    def test_missing_file_loads_as_none(self):
-        self.assertIsNone(load_state(self.path))
-
-    def test_save_then_load_round_trips(self):
-        state = AnalyticsState(install_id="a" * 32, last_attempt_at=1790000000.5)
-
-        self.assertTrue(save_state(state, self.path))
-        self.assertEqual(load_state(self.path), state)
-
-    def test_unusable_files_load_as_none(self):
-        for content in (
-            "{not json",
-            '["a"]',
-            '{"install_id": "short", "last_attempt_at": 1}',
-            '{"install_id": "' + "a" * 32 + '"}',
-            '{"install_id": "' + "a" * 32 + '", "last_attempt_at": true}',
-        ):
-            with self.subTest(content=content):
-                self.write(content)
-                self.assertIsNone(load_state(self.path))
-
-    def test_save_reports_failure_instead_of_raising(self):
-        missing = os.path.join(self.dir.name, "missing", ".analytics.json")
-
-        self.assertFalse(save_state(new_state(), missing))
-
-    def test_new_state_has_a_hex_id_and_no_attempt(self):
-        state = new_state()
-
-        self.assertRegex(state.install_id, r"^[0-9a-f]{32}$")
-        self.assertEqual(state.last_attempt_at, 0.0)
-
-    def test_delete_removes_the_file_and_tolerates_a_missing_one(self):
-        save_state(new_state(), self.path)
-
-        delete_state(self.path)
-        delete_state(self.path)
-
-        self.assertFalse(os.path.exists(self.path))

frigate/test/test_analytics_transport.py

@@ -1,60 +0,0 @@
-"""Tests for sending a report."""
-
-import unittest
-from unittest.mock import Mock, patch
-
-import requests
-
-from frigate.analytics.transport import TIMEOUT_S, SendOutcome, send_report
-from frigate.version import VERSION
-
-URL = "https://example.test/report"
-
-
-def post(status: int = 204, text: str = "", side_effect: Exception | None = None):
-    return patch(
-        "frigate.analytics.transport.requests.post",
-        return_value=Mock(status_code=status, text=text),
-        side_effect=side_effect,
-    )
-
-
-class TestSendReport(unittest.TestCase):
-    def test_posts_the_body_as_json_with_a_user_agent(self):
-        with post() as mock_post:
-            outcome = send_report(URL, '{"a":1}')
-
-        self.assertIs(outcome, SendOutcome.accepted)
-        args, kwargs = mock_post.call_args
-        self.assertEqual(args[0], URL)
-        self.assertEqual(kwargs["data"], b'{"a":1}')
-        self.assertEqual(kwargs["headers"]["Content-Type"], "application/json")
-        self.assertEqual(kwargs["headers"]["User-Agent"], f"Frigate/{VERSION}")
-        self.assertFalse(kwargs["allow_redirects"])
-        self.assertEqual(kwargs["timeout"], TIMEOUT_S)
-
-    def test_maps_statuses_to_outcomes(self):
-        cases = (
-            (200, SendOutcome.accepted),
-            (400, SendOutcome.rejected),
-            (429, SendOutcome.rate_limited),
-            (302, SendOutcome.failed),
-            (500, SendOutcome.failed),
-        )
-
-        for status, outcome in cases:
-            with self.subTest(status=status), post(status):
-                self.assertIs(send_report(URL, "{}"), outcome)
-
-    def test_logs_the_rejection_reason(self):
-        with (
-            post(400, "install_id: bad"),
-            self.assertLogs("frigate.analytics.transport", "WARNING") as logs,
-        ):
-            send_report(URL, "{}")
-
-        self.assertIn("install_id: bad", logs.output[0])
-
-    def test_a_network_error_fails_without_raising(self):
-        with post(side_effect=requests.ConnectionError("down")):
-            self.assertIs(send_report(URL, "{}"), SendOutcome.failed)

frigate/test/test_builtin.py

@@ -36,6 +36,31 @@ class TestEventsPerSecond(unittest.TestCase):
             clock[0] += 100.0
             self.assertEqual(eps.eps(), 0.0)
 
+    def test_burst_after_start_is_not_divided_by_a_tiny_window(self) -> None:
+        eps = EventsPerSecond(last_n_seconds=10)
+        clock = [1000.0]
+        with patch("frigate.util.builtin.time.monotonic", side_effect=lambda: clock[0]):
+            eps.start()
+            # eleven buffered frames arrive within 100 ms of starting
+            for _ in range(11):
+                clock[0] += 0.01
+                eps.update()
+            # 11 events over less than a second is at most 11 per second
+            self.assertLessEqual(eps.eps(), 11.0)
+
+    def test_subsecond_window_keeps_its_rate(self) -> None:
+        eps = EventsPerSecond(last_n_seconds=0.5)
+        clock = [1000.0]
+        with patch("frigate.util.builtin.time.monotonic", side_effect=lambda: clock[0]):
+            eps.start()
+            # twenty events per second for two seconds
+            for _ in range(40):
+                clock[0] += 0.05
+                eps.update()
+            # read between events, so none sits exactly on the window edge
+            clock[0] += 0.01
+            self.assertAlmostEqual(eps.eps(), 20.0)
+
 
 if __name__ == "__main__":
     unittest.main()

frigate/test/test_config.py

@@ -17,11 +17,6 @@ from frigate.util.builtin import deep_merge
 
 
 class TestConfig(unittest.TestCase):
-    def test_analytics_is_off_by_default(self):
-        frigate_config = FrigateConfig(**self.minimal)
-
-        self.assertFalse(frigate_config.telemetry.analytics)
-
     def setUp(self):
         self.minimal = {
             "mqtt": {"host": "mqtt"},

frigate/test/test_config_util.py

@@ -82,30 +82,5 @@ class TestSwapRuntimeConfig(unittest.TestCase):
         app.genai_manager.update_config.assert_called_once_with(config)
 
 
-class TestConfigHolder(unittest.TestCase):
-    def test_set_passes_the_new_config_to_subscribers(self) -> None:
-        holder = ConfigHolder(MagicMock(name="boot_config"))
-        listener = MagicMock()
-        holder.subscribe(listener)
-        config = MagicMock(name="new_config")
-
-        holder.set(config)
-
-        listener.assert_called_once_with(config)
-
-    def test_a_failing_subscriber_does_not_block_the_swap(self) -> None:
-        holder = ConfigHolder(MagicMock(name="boot_config"))
-        after = MagicMock()
-        holder.subscribe(MagicMock(side_effect=RuntimeError("boom")))
-        holder.subscribe(after)
-        config = MagicMock(name="new_config")
-
-        with self.assertLogs("frigate.config.holder", "ERROR"):
-            holder.set(config)
-
-        self.assertIs(holder.config, config)
-        after.assert_called_once_with(config)
-
-
 if __name__ == "__main__":
     unittest.main()

frigate/test/test_detector_device.py

@@ -59,6 +59,10 @@ class TestBuildDetectorConfig(unittest.TestCase):
     def test_detectors_that_name_the_field_something_else(self):
         self.assertEqual(self._build("cpu:4").num_threads, 4)
         self.assertEqual(self._build("rknn:2").num_cores, 2)
+        self.assertEqual(
+            self._build("zmq:tcp://host.docker.internal:5555").endpoint,
+            "tcp://host.docker.internal:5555",
+        )
 
     def test_device_is_coerced_to_the_detector_field_type(self):
         self.assertEqual(self._build("tensorrt:1").device, 1)
@@ -66,6 +70,7 @@ class TestBuildDetectorConfig(unittest.TestCase):
     def test_omitted_device_falls_back_to_the_detector_default(self):
         self.assertEqual(self._build("cpu").num_threads, 3)
         self.assertEqual(self._build("rknn").num_cores, 0)
+        self.assertEqual(self._build("zmq").endpoint, "ipc:///tmp/cache/zmq_detector")
         self.assertEqual(self._build("openvino").device, "AUTO")
         self.assertIsNone(self._build("edgetpu").device)
 

frigate/test/test_detector_hardware.py

@@ -25,7 +25,7 @@ class HardwareProbeTestCase(unittest.TestCase):
         self.root = tempfile.TemporaryDirectory()
         self.addCleanup(self.root.cleanup)
 
-        for name in ("SYS_ROOT", "DEV_ROOT", "PROC_ROOT", "ETC_ROOT"):
+        for name in ("SYS_ROOT", "DEV_ROOT", "PROC_ROOT", "ETC_ROOT", "LIB_ROOT"):
             sub = os.path.join(self.root.name, name.split("_")[0].lower())
             os.makedirs(sub, exist_ok=True)
             patcher = patch.object(hardware, name, sub)
@@ -167,6 +167,29 @@ class TestNvidia(HardwareProbeTestCase):
 
 
 class TestAccelerators(HardwareProbeTestCase):
+    def test_the_neural_engine_is_found_by_lighters_provider_library(self):
+        write(os.path.join(self.lib_root, "lighter", "liblighter_ane_ep.so"))
+
+        with patch.dict(os.environ, clear=False) as env:
+            env.pop("LIGHTER_ANE_EP", None)
+            ane = self.probe()["onnx:lighter"]
+
+        self.assertEqual(ane.detector, "onnx")
+        self.assertEqual(ane.units[0].device, "onnx")
+        self.assertEqual(ane.units[0].label, "Neural Engine")
+
+    def test_the_neural_engine_is_found_where_lighter_ane_ep_points(self):
+        library = os.path.join(self.root.name, "elsewhere", "liblighter_ane_ep.so")
+        write(library)
+
+        with patch.dict(os.environ, {"LIGHTER_ANE_EP": library}):
+            self.assertIn("onnx:lighter", self.probe())
+
+    def test_no_neural_engine_is_reported_without_the_library(self):
+        with patch.dict(os.environ, clear=False) as env:
+            env.pop("LIGHTER_ANE_EP", None)
+            self.assertNotIn("onnx:lighter", self.probe())
+
     def test_hailo_is_found_by_its_device_node(self):
         write(os.path.join(self.dev_root, "hailo0"))
 

frigate/test/test_ffmpeg_presets.py

@@ -51,6 +51,16 @@ class TestFfmpegPresets(unittest.TestCase):
             " ".join(frigate_config.cameras["back"].ffmpeg_cmds[0]["cmd"])
         )
 
+    def test_ffmpeg_hwaccel_apple_preset_decodes_every_stream(self):
+        self.default_ffmpeg["cameras"]["back"]["ffmpeg"]["hwaccel_args"] = (
+            "preset-apple-silicon-h265"
+        )
+        frigate_config = FrigateConfig(**self.default_ffmpeg)
+        cmd = " ".join(frigate_config.cameras["back"].ffmpeg_cmds[0]["cmd"])
+        assert "-c:v hevc_v4l2m2m" in cmd
+        assert "-c:v:1" not in cmd
+        assert "scale=1920:1080" in cmd
+
     def test_ffmpeg_hwaccel_not_preset(self):
         self.default_ffmpeg["cameras"]["back"]["ffmpeg"]["hwaccel_args"] = (
             "-other-hwaccel args"

frigate/test/test_hwaccel_recommendation.py

@@ -34,6 +34,12 @@ class HwaccelRecommendationTestCase(unittest.TestCase):
         patcher.start()
         self.addCleanup(patcher.stop)
 
+        self.sys_root = os.path.join(self.root.name, "sys")
+        os.makedirs(self.sys_root)
+        patcher = patch.object(hwaccel, "SYS_ROOT", self.sys_root)
+        patcher.start()
+        self.addCleanup(patcher.stop)
+
         drm = patch.object(hwaccel, "enumerate_drm_devices", return_value={})
         self.drm = drm.start()
         self.addCleanup(drm.stop)
@@ -66,6 +72,12 @@ class HwaccelRecommendationTestCase(unittest.TestCase):
         with open(os.path.join(self.proc_root, "cpuinfo"), "w") as f:
             f.write(f"processor\t: 0\nmodel name\t: {model_name}\n")
 
+    def write_video_device(self, vendor: str) -> None:
+        device = os.path.join(self.sys_root, "class", "video4linux", "video0", "device")
+        os.makedirs(device)
+        with open(os.path.join(device, "vendor"), "w") as f:
+            f.write(f"{vendor}\n")
+
     def write_device_tree(self) -> None:
         os.makedirs(os.path.join(self.proc_root, "device-tree"), exist_ok=True)
         with open(os.path.join(self.proc_root, "device-tree", "compatible"), "w") as f:
@@ -191,6 +203,22 @@ class TestAvailableFamilies(HwaccelRecommendationTestCase):
         self.assertIn(recommended, [family.key for family in families])
 
 
+class TestLighter(HwaccelRecommendationTestCase):
+    def test_lighters_media_engine_is_recommended(self):
+        self.write_video_device(hwaccel.LIGHTER_VIRTIO_VENDOR)
+
+        self.assertEqual(self.recommend(codecs={"h264"}), "apple-silicon")
+        self.assertEqual(
+            self.presets()["apple-silicon"],
+            {"h264": "preset-apple-silicon-h264", "h265": "preset-apple-silicon-h265"},
+        )
+
+    def test_another_virtio_media_device_is_not_lighters(self):
+        self.write_video_device("0x554d4551")
+
+        self.assertEqual(self.available(), [])
+
+
 class TestCodecCoverage(HwaccelRecommendationTestCase):
     def test_a_family_carries_a_preset_per_codec(self):
         self.assertEqual(

frigate/test/test_live_streams.py

@@ -0,0 +1,397 @@
+"""Tests for Frigate-managed go2rtc live streams."""
+
+import unittest
+from unittest.mock import MagicMock, call, patch
+
+import requests
+from pydantic import ValidationError
+
+from frigate.config import FrigateConfig
+from frigate.util.live_streams import (
+    DEFAULT_TRANSCODE_QUALITIES,
+    default_transcode_source,
+    generated_transcode_streams,
+    is_transcode_stream_name,
+    measure_stream_bitrate,
+    raw_transcode_streams,
+    sync_transcode_streams,
+    transcode_stream_name,
+    transcode_stream_source,
+)
+
+
+class TestTranscodeNaming(unittest.TestCase):
+    def test_stream_name(self):
+        self.assertEqual(transcode_stream_name("front", 720), "front_transcode_720p")
+
+    def test_is_transcode_stream_name(self):
+        self.assertTrue(is_transcode_stream_name("front", "front_transcode_480p"))
+        self.assertFalse(is_transcode_stream_name("front", "front_sub"))
+        self.assertFalse(is_transcode_stream_name("front", "back_transcode_480p"))
+        self.assertFalse(is_transcode_stream_name("front", "front_transcode_480"))
+
+    def test_source_gives_each_ffmpeg_token_its_own_raw_param(self):
+        self.assertEqual(
+            transcode_stream_source("front", 480, 500),
+            "ffmpeg:front#video=h264#height=480#hardware#audio=copy"
+            "#raw=-b:v#raw=500k#raw=-maxrate#raw=500k#raw=-bufsize#raw=1000k",
+        )
+
+    def test_default_source_skips_transcoded_streams(self):
+        streams = {"Low": "front_transcode_360p", "Main": "front_main"}
+        self.assertEqual(default_transcode_source("front", streams), "front_main")
+        self.assertIsNone(default_transcode_source("front", {}))
+
+
+class TestRawTranscodeStreams(unittest.TestCase):
+    def test_defaults_to_camera_stream_and_default_qualities(self):
+        config = {"cameras": {"front": {"live": {"transcode": {"enabled": True}}}}}
+        streams = raw_transcode_streams(config)
+
+        self.assertEqual(
+            list(streams),
+            [
+                transcode_stream_name("front", q["height"])
+                for q in DEFAULT_TRANSCODE_QUALITIES
+            ],
+        )
+        self.assertTrue(streams["front_transcode_720p"].startswith("ffmpeg:front#"))
+
+    def test_uses_first_live_stream_and_explicit_qualities(self):
+        config = {
+            "cameras": {
+                "front": {
+                    "live": {
+                        "streams": {"Main": "front_main", "Sub": "front_sub"},
+                        "transcode": {
+                            "enabled": True,
+                            "qualities": [{"height": 540, "bitrate": 800}],
+                        },
+                    }
+                }
+            }
+        }
+
+        self.assertEqual(
+            raw_transcode_streams(config),
+            {"front_transcode_540p": transcode_stream_source("front_main", 540, 800)},
+        )
+
+    def test_explicit_source_wins(self):
+        config = {
+            "cameras": {
+                "front": {
+                    "live": {
+                        "streams": {"Main": "front_main"},
+                        "transcode": {
+                            "enabled": True,
+                            "source": "front_sub",
+                            "qualities": [{"height": 360, "bitrate": 250}],
+                        },
+                    }
+                }
+            }
+        }
+
+        self.assertEqual(
+            raw_transcode_streams(config)["front_transcode_360p"],
+            transcode_stream_source("front_sub", 360, 250),
+        )
+
+    def test_malformed_qualities_are_skipped(self):
+        config = {
+            "cameras": {
+                "front": {
+                    "live": {
+                        "transcode": {
+                            "enabled": True,
+                            "qualities": [
+                                {"height": 720},
+                                "480",
+                                {"height": 360, "bitrate": 250},
+                            ],
+                        }
+                    }
+                },
+                "back": {
+                    "live": {"transcode": {"enabled": True, "qualities": {"a": 1}}}
+                },
+            }
+        }
+
+        self.assertEqual(list(raw_transcode_streams(config)), ["front_transcode_360p"])
+
+    def test_disabled_or_missing_generates_nothing(self):
+        self.assertEqual(raw_transcode_streams({}), {})
+        self.assertEqual(
+            raw_transcode_streams({"cameras": {"front": {"live": {}}}}), {}
+        )
+        self.assertEqual(
+            raw_transcode_streams(
+                {"cameras": {"front": {"live": {"transcode": {"enabled": False}}}}}
+            ),
+            {},
+        )
+
+
+def camera_config(live: dict | None = None, go2rtc: dict | None = None) -> dict:
+    config = {
+        "mqtt": {"host": "mqtt"},
+        "go2rtc": {
+            "streams": go2rtc
+            or {
+                "front": ["rtsp://10.0.0.1:554/main"],
+                "front_sub": ["rtsp://10.0.0.1:554/sub"],
+            }
+        },
+        "cameras": {
+            "front": {
+                "ffmpeg": {
+                    "inputs": [
+                        {"path": "rtsp://10.0.0.1:554/main", "roles": ["detect"]}
+                    ]
+                },
+                "detect": {"height": 1080, "width": 1920, "fps": 5},
+            }
+        },
+    }
+
+    if live is not None:
+        config["cameras"]["front"]["live"] = live
+
+    return config
+
+
+class TestLiveTranscodeConfig(unittest.TestCase):
+    def streams(self, live: dict, go2rtc: dict | None = None) -> dict[str, str]:
+        config = FrigateConfig(**camera_config(live, go2rtc))
+        return config.cameras["front"].live.streams
+
+    def test_global_transcode_is_ignored(self):
+        config = camera_config()
+        config["live"] = {"transcode": {"enabled": True}}
+
+        streams = FrigateConfig(**config).cameras["front"].live.streams
+        self.assertEqual(streams, {"front": "front"})
+
+    def test_disabled_leaves_streams_alone(self):
+        self.assertEqual(self.streams({}), {"front": "front"})
+
+    def test_enabled_appends_default_qualities(self):
+        streams = self.streams({"transcode": {"enabled": True}})
+
+        self.assertEqual(
+            list(streams.items()),
+            [
+                ("front", "front"),
+                ("720p", "front_transcode_720p"),
+                ("480p", "front_transcode_480p"),
+                ("360p", "front_transcode_360p"),
+            ],
+        )
+
+    def test_source_resolves_to_first_live_stream(self):
+        config = FrigateConfig(
+            **camera_config(
+                {
+                    "streams": {"Sub": "front_sub", "Main": "front"},
+                    "transcode": {"enabled": True},
+                }
+            )
+        )
+
+        self.assertEqual(config.cameras["front"].live.transcode.source, "front_sub")
+
+    def test_placed_entries_keep_position_and_label(self):
+        streams = self.streams(
+            {
+                "streams": {
+                    "Main": "front",
+                    "Low": "front_transcode_480p",
+                    "Sub": "front_sub",
+                },
+                "transcode": {"enabled": True},
+            }
+        )
+
+        self.assertEqual(
+            list(streams.items()),
+            [
+                ("Main", "front"),
+                ("Low", "front_transcode_480p"),
+                ("Sub", "front_sub"),
+                ("720p", "front_transcode_720p"),
+                ("360p", "front_transcode_360p"),
+            ],
+        )
+
+    def test_disabling_drops_transcoded_entries(self):
+        streams = self.streams(
+            {
+                "streams": {"Main": "front", "720p": "front_transcode_720p"},
+                "transcode": {"enabled": False},
+            }
+        )
+
+        self.assertEqual(streams, {"Main": "front"})
+
+    def test_changed_height_drops_the_old_entry(self):
+        streams = self.streams(
+            {
+                "streams": {"Main": "front", "720p": "front_transcode_720p"},
+                "transcode": {
+                    "enabled": True,
+                    "qualities": [{"height": 540, "bitrate": 800}],
+                },
+            }
+        )
+
+        self.assertEqual(streams, {"Main": "front", "540p": "front_transcode_540p"})
+
+    def test_real_go2rtc_stream_with_transcode_name_is_kept(self):
+        streams = self.streams(
+            {"streams": {"Main": "front", "Odd": "front_transcode_720p"}},
+            go2rtc={
+                "front": ["rtsp://10.0.0.1:554/main"],
+                "front_transcode_720p": ["rtsp://10.0.0.1:554/odd"],
+            },
+        )
+
+        self.assertEqual(streams, {"Main": "front", "Odd": "front_transcode_720p"})
+
+    def test_generated_name_colliding_with_go2rtc_stream_fails(self):
+        with self.assertRaises(ValidationError):
+            self.streams(
+                {"transcode": {"enabled": True}},
+                go2rtc={
+                    "front": ["rtsp://10.0.0.1:554/main"],
+                    "front_transcode_720p": ["rtsp://10.0.0.1:554/odd"],
+                },
+            )
+
+    def test_source_must_be_a_go2rtc_stream(self):
+        with self.assertRaises(ValidationError):
+            self.streams({"transcode": {"enabled": True, "source": "missing"}})
+
+    def test_duplicate_heights_fail(self):
+        with self.assertRaises(ValidationError):
+            self.streams(
+                {
+                    "transcode": {
+                        "enabled": True,
+                        "qualities": [
+                            {"height": 480, "bitrate": 500},
+                            {"height": 480, "bitrate": 600},
+                        ],
+                    }
+                }
+            )
+
+    def test_label_collision_fails(self):
+        with self.assertRaises(ValidationError):
+            self.streams(
+                {
+                    "streams": {"Main": "front", "720p": "front_sub"},
+                    "transcode": {"enabled": True},
+                }
+            )
+
+
+class TestGeneratedTranscodeStreams(unittest.TestCase):
+    def test_collects_enabled_cameras(self):
+        config = FrigateConfig(
+            **camera_config(
+                {
+                    "transcode": {
+                        "enabled": True,
+                        "qualities": [{"height": 480, "bitrate": 500}],
+                    }
+                }
+            )
+        )
+
+        self.assertEqual(
+            generated_transcode_streams(config),
+            {"front_transcode_480p": transcode_stream_source("front", 480, 500)},
+        )
+
+    def test_disabled_is_empty(self):
+        self.assertEqual(
+            generated_transcode_streams(FrigateConfig(**camera_config())), {}
+        )
+
+
+class TestSyncTranscodeStreams(unittest.TestCase):
+    @patch("frigate.util.live_streams.requests.request")
+    def test_puts_added_and_changed_and_deletes_removed(self, mock_request):
+        mock_request.return_value = MagicMock(ok=True)
+
+        ok = sync_transcode_streams(
+            {"a": "src-a", "b": "src-b", "c": "src-c"},
+            {"a": "src-a", "b": "src-b2", "d": "src-d"},
+        )
+
+        self.assertTrue(ok)
+        url = "http://127.0.0.1:1984/api/streams"
+        self.assertCountEqual(
+            mock_request.call_args_list,
+            [
+                call("put", url, params={"name": "b", "src": "src-b2"}, timeout=5),
+                call("put", url, params={"name": "d", "src": "src-d"}, timeout=5),
+                call("delete", url, params={"src": "c"}, timeout=5),
+            ],
+        )
+
+    @patch("frigate.util.live_streams.requests.request")
+    def test_unchanged_makes_no_calls(self, mock_request):
+        self.assertTrue(sync_transcode_streams({"a": "x"}, {"a": "x"}))
+        mock_request.assert_not_called()
+
+    @patch("frigate.util.live_streams.requests.request")
+    def test_failure_returns_false_and_keeps_going(self, mock_request):
+        mock_request.side_effect = [
+            requests.ConnectionError("down"),
+            MagicMock(ok=True),
+        ]
+
+        self.assertFalse(sync_transcode_streams({}, {"a": "x", "b": "y"}))
+        self.assertEqual(mock_request.call_count, 2)
+
+
+class TestMeasureStreamBitrate(unittest.TestCase):
+    @patch("frigate.util.live_streams.time.monotonic")
+    @patch("frigate.util.live_streams.requests.get")
+    def test_skips_warmup_and_averages(self, mock_get, mock_monotonic):
+        response = MagicMock(ok=True)
+        response.iter_content.return_value = [b"x" * 1000] * 6
+        mock_get.return_value.__enter__.return_value = response
+        # first byte, warmup, window start, then counted chunks up to 6 s
+        mock_monotonic.side_effect = [0.0, 0.5, 1.0, 2.0, 4.0, 7.0]
+
+        kbps = measure_stream_bitrate("front", duration=6.0, warmup=1.0)
+
+        self.assertAlmostEqual(kbps, 3000 * 8 / 1000 / 6.0)
+        mock_get.assert_called_once_with(
+            "http://127.0.0.1:1984/api/stream.mp4",
+            params={"src": "front"},
+            stream=True,
+            timeout=5,
+        )
+
+    @patch("frigate.util.live_streams.requests.get")
+    def test_no_data_returns_none(self, mock_get):
+        response = MagicMock(ok=True)
+        response.iter_content.return_value = []
+        mock_get.return_value.__enter__.return_value = response
+
+        self.assertIsNone(measure_stream_bitrate("front"))
+
+    @patch("frigate.util.live_streams.requests.get")
+    def test_request_error_returns_none(self, mock_get):
+        mock_get.side_effect = requests.ReadTimeout("slow")
+
+        self.assertIsNone(measure_stream_bitrate("front"))
+
+
+if __name__ == "__main__":
+    unittest.main()

frigate/test/test_notice_registry.py

@@ -16,9 +16,7 @@ from frigate.test.const import TEST_DB, TEST_DB_CLEANUPS
 
 # kinds that switch on the lifecycle knobs, so the tests do not depend on the
 # values the real catalog picks
-BATCHED = NoticeKind(
+BATCHED = NoticeKind("batched", NoticeSeverity.warning, "system", batch_repeats=True)
-    "batched", NoticeSeverity.warning, "system", batch_repeats=True, reopen_at_count=3
-)
 PRUNED = NoticeKind("pruned", NoticeSeverity.info, "system", keep_latest=2)
 TEST_KINDS = {kind.key: kind for kind in (BATCHED, PRUNED)}
 
@@ -48,16 +46,6 @@ class TestNoticeKinds(unittest.TestCase):
 
         self.assertIsNone(kind.link_for({"version": "0.19.1"}))
 
-    def test_analytics_prompt_links_to_telemetry_settings(self):
-        kind = NOTICE_KINDS["analytics_prompt"]
-
-        self.assertEqual(kind.link_for({}), "/settings?page=systemTelemetry")
-        self.assertFalse(kind.counts_repeats)
-        self.assertFalse(kind.reportable)
-
-    def test_update_available_is_not_reported(self):
-        self.assertFalse(NOTICE_KINDS["update_available"].reportable)
-
 
 class RegistryTestCase(unittest.TestCase):
     def setUp(self):
@@ -87,6 +75,11 @@ class RegistryTestCase(unittest.TestCase):
             mock_datetime.now.return_value.timestamp.return_value = timestamp
             self.registry.raise_notice(kind, **kwargs)
 
+    def _acknowledge_at(self, timestamp: float, row_id: str) -> None:
+        with patch("frigate.notices.registry.datetime") as mock_datetime:
+            mock_datetime.now.return_value.timestamp.return_value = timestamp
+            self.registry.acknowledge(row_id)
+
 
 class TestNoticeRegistry(RegistryTestCase):
     def test_raise_inserts_and_counts_one_occurrence(self):
@@ -132,34 +125,98 @@ class TestNoticeRegistry(RegistryTestCase):
         self.assertEqual(self.registry.stats()[0]["occurrences"], 1)
         self.listener.assert_not_called()
 
-    def test_dismissal_survives_a_re_raise(self):
+    def test_acknowledged_notice_returns_on_a_re_raise(self):
+        self.registry.raise_notice("detector_stuck", scope="ov", params={})
+        self.assertTrue(self.registry.acknowledge("detector_stuck:ov"))
+        self.assertEqual(self.registry.active(), [])
+
+        self.registry.raise_notice("detector_stuck", scope="ov", params={})
+
+        notice = self.registry.active()[0]
+        self.assertEqual(notice["count"], 2)
+        self.assertIsNone(notice["acknowledged_at"])
+
+    def test_muted_notice_stays_hidden_on_a_re_raise(self):
         self.registry.raise_notice("skipped_detections", scope="front_door", params={})
-        self.assertTrue(self.registry.dismiss("skipped_detections:front_door"))
+        self.assertTrue(self.registry.mute("skipped_detections:front_door"))
 
         self.registry.raise_notice("skipped_detections", scope="front_door", params={})
 
         self.assertEqual(self.registry.active(), [])
-        history = self.registry.active(include_dismissed=True)
+        hidden = self.registry.active(include_hidden=True)
-        self.assertEqual(history[0]["count"], 2)
+        self.assertEqual(hidden[0]["count"], 2)
-        self.assertIsNotNone(history[0]["dismissed_at"])
+        self.assertIsNotNone(hidden[0]["muted_at"])
 
-    def test_dismiss_counts_once(self):
+    def test_muting_an_acknowledged_notice_replaces_the_acknowledgement(self):
         self.registry.raise_notice("detector_stuck", scope="ov", params={})
+        self.registry.acknowledge("detector_stuck:ov")
 
-        self.assertTrue(self.registry.dismiss("detector_stuck:ov"))
+        self.assertTrue(self.registry.mute("detector_stuck:ov"))
-        self.assertTrue(self.registry.dismiss("detector_stuck:ov"))
 
-        self.assertEqual(self.registry.stats()[0]["dismissals"], 1)
+        notice = self.registry.active(include_hidden=True)[0]
+        self.assertIsNone(notice["acknowledged_at"])
+        self.assertIsNotNone(notice["muted_at"])
 
-    def test_dismiss_unknown_id(self):
+    def test_acknowledging_a_muted_notice_keeps_it_muted(self):
-        self.assertFalse(self.registry.dismiss("nope"))
-
-    def test_dismissed_hidden_unless_requested(self):
         self.registry.raise_notice("detector_stuck", scope="ov", params={})
-        self.registry.dismiss("detector_stuck:ov")
+        self.registry.mute("detector_stuck:ov")
+
+        self.assertTrue(self.registry.acknowledge("detector_stuck:ov"))
+
+        notice = self.registry.active(include_hidden=True)[0]
+        self.assertIsNone(notice["acknowledged_at"])
+        self.assertIsNotNone(notice["muted_at"])
+
+    def test_acknowledge_and_mute_each_count_once(self):
+        self.registry.raise_notice("detector_stuck", scope="ov", params={})
+        self.registry.raise_notice("shm_too_low", params={})
+
+        self.assertTrue(self.registry.acknowledge("detector_stuck:ov"))
+        self.assertTrue(self.registry.acknowledge("detector_stuck:ov"))
+        self.assertTrue(self.registry.mute("shm_too_low"))
+        self.assertTrue(self.registry.mute("shm_too_low"))
+
+        stats = {s["kind"]: s for s in self.registry.stats()}
+        self.assertEqual(stats["detector_stuck"]["acknowledgements"], 1)
+        self.assertEqual(stats["detector_stuck"]["mutes"], 0)
+        self.assertEqual(stats["shm_too_low"]["mutes"], 1)
+
+    def test_unknown_ids_are_rejected(self):
+        self.assertFalse(self.registry.acknowledge("nope"))
+        self.assertFalse(self.registry.mute("nope"))
+        self.assertFalse(self.registry.unhide("nope"))
+
+    def test_kinds_that_never_repeat_cannot_be_acknowledged(self):
+        self.registry.raise_notice(
+            "update_available", scope="0.19.1", params={"version": "0.19.1"}
+        )
+
+        self.assertFalse(self.registry.acknowledge("update_available:0.19.1"))
+        self.assertFalse(
+            self.registry.acknowledge("config:detect:fps-greater-than-five:global")
+        )
+        self.assertEqual(self.registry.active()[0]["acknowledgeable"], False)
+
+    def test_hidden_notices_listed_only_when_requested(self):
+        self.registry.raise_notice("detector_stuck", scope="ov", params={})
+        self.registry.acknowledge("detector_stuck:ov")
 
         self.assertEqual(self.registry.active(), [])
-        self.assertEqual(len(self.registry.active(include_dismissed=True)), 1)
+        self.assertEqual(len(self.registry.active(include_hidden=True)), 1)
+
+    def test_unhide_shows_a_notice_and_drops_a_check_mute(self):
+        self.registry.raise_notice("detector_stuck", scope="ov", params={})
+        self.registry.mute("detector_stuck:ov")
+        self.registry.mute("config:detect:fps-greater-than-five:global")
+
+        self.assertTrue(self.registry.unhide("detector_stuck:ov"))
+        self.assertTrue(
+            self.registry.unhide("config:detect:fps-greater-than-five:global")
+        )
+
+        notice = self.registry.active()[0]
+        self.assertIsNone(notice["muted_at"])
+        self.assertEqual(self.registry.muted_checks(), [])
 
     def test_resolve_deletes_and_keeps_stats(self):
         self.registry.raise_notice(
@@ -170,7 +227,7 @@ class TestNoticeRegistry(RegistryTestCase):
         self.registry.resolve("model_download_failed", "yolo/model.onnx")
         self.registry.resolve("model_download_failed", "yolo/model.onnx")
 
-        self.assertEqual(self.registry.active(include_dismissed=True), [])
+        self.assertEqual(self.registry.active(include_hidden=True), [])
         self.assertEqual(self.registry.stats()[0]["occurrences"], 1)
         self.listener.assert_called_once()
 
@@ -247,63 +304,47 @@ class TestNoticeRegistry(RegistryTestCase):
             ids, ["model_download_failed:front_door", "skipped_detections:garage"]
         )
 
-    def test_resolve_camera_drops_that_cameras_check_dismissals(self):
+    def test_resolve_camera_drops_that_cameras_check_mutes(self):
         for check_id in (
             "stream:front_door:0:probe",
             "config:detect:fps-greater-than-five:camera.front_door",
             "config:detect:fps-greater-than-five:global",
             "stream:garage:0:probe",
         ):
-            self.assertTrue(self.registry.dismiss(check_id))
+            self.assertTrue(self.registry.mute(check_id))
 
         self.registry.resolve_camera("front_door")
 
-        ids = sorted(check["id"] for check in self.registry.dismissed_checks())
+        ids = sorted(check["id"] for check in self.registry.muted_checks())
         self.assertEqual(
             ids,
             ["config:detect:fps-greater-than-five:global", "stream:garage:0:probe"],
         )
 
-    def test_camera_named_global_keeps_global_check_dismissals(self):
+    def test_camera_named_global_keeps_global_check_mutes(self):
-        self.registry.dismiss("config:detect:fps-greater-than-five:global")
+        self.registry.mute("config:detect:fps-greater-than-five:global")
-        self.registry.dismiss("config:detect:fps-greater-than-five:camera.global")
+        self.registry.mute("config:detect:fps-greater-than-five:camera.global")
 
         self.registry.resolve_camera("global")
 
-        ids = [check["id"] for check in self.registry.dismissed_checks()]
+        ids = [check["id"] for check in self.registry.muted_checks()]
         self.assertEqual(ids, ["config:detect:fps-greater-than-five:global"])
 
-    def test_purge_dismissed_keeps_active_notices_and_counts(self):
+    def test_unhide_all_shows_every_notice_and_keeps_counts(self):
         self.registry.raise_notice("detector_stuck", scope="ov", params={})
         self.registry.raise_notice("skipped_detections", scope="garage", params={})
-        self.registry.dismiss("detector_stuck:ov")
+        self.registry.acknowledge("detector_stuck:ov")
-        self.registry.dismiss("config:detect:fps-greater-than-five:camera.garage")
+        self.registry.mute("skipped_detections:garage")
+        self.registry.mute("config:detect:fps-greater-than-five:camera.garage")
 
-        self.assertEqual(self.registry.purge_dismissed(), 2)
+        self.registry.unhide_all()
 
-        ids = [n["id"] for n in self.registry.active(include_dismissed=True)]
+        ids = sorted(n["id"] for n in self.registry.active())
-        self.assertEqual(ids, ["skipped_detections:garage"])
+        self.assertEqual(ids, ["detector_stuck:ov", "skipped_detections:garage"])
-        self.assertEqual(self.registry.dismissed_checks(), [])
+        self.assertEqual(self.registry.muted_checks(), [])
-        dismissals = {s["kind"]: s["dismissals"] for s in self.registry.stats()}
+        stats = {s["kind"]: s for s in self.registry.stats()}
-        self.assertEqual(dismissals["detector_stuck"], 1)
+        self.assertEqual(stats["detector_stuck"]["acknowledgements"], 1)
-
+        self.assertEqual(stats["skipped_detections"]["mutes"], 1)
-
-class TestMarkReported(RegistryTestCase):
-    def test_moves_watermarks_to_the_snapshot_not_the_current_count(self):
-        self.registry.raise_notice(
-            "detector_stuck", scope="ov", params={"detector": "ov"}
-        )
-        snapshot = self.registry.stats()
-        self.registry.raise_notice(
-            "detector_stuck", scope="ov", params={"detector": "ov"}
-        )
-
-        self.registry.mark_reported(snapshot)
-
-        row = self.registry.stats()[0]
-        self.assertEqual(row["occurrences"], 2)
-        self.assertEqual(row["reported_occurrences"], 1)
-        self.assertEqual(row["reported_dismissals"], 0)
 
 
 class TestApply(RegistryTestCase):
@@ -377,7 +418,7 @@ class TestLifecycleKnobs(RegistryTestCase):
 
         self.registry.flush()
 
-        self.assertEqual(self.registry.active(include_dismissed=True), [])
+        self.assertEqual(self.registry.active(include_hidden=True), [])
         self.listener.assert_not_called()
 
     def test_a_new_row_starts_without_stale_repeats(self):
@@ -390,32 +431,26 @@ class TestLifecycleKnobs(RegistryTestCase):
 
         self.assertEqual(self.registry.active()[0]["count"], 1)
 
-    def test_a_dismissed_notice_reopens_at_the_count(self):
+    def test_an_acknowledged_notice_returns_when_a_later_repeat_flushes(self):
-        self.registry.raise_notice("batched")
+        self._raise_at(1000.0, "batched")
-        self.registry.dismiss("batched")
+        self._acknowledge_at(1010.0, "batched")
 
-        self.registry.raise_notice("batched")
+        self._raise_at(1020.0, "batched")
-        self.registry.flush()
         self.assertEqual(self.registry.active(), [])
 
-        self.registry.raise_notice("batched")
         self.registry.flush()
 
-        notice = self.registry.active()[0]
+        self.assertEqual(self.registry.active()[0]["count"], 2)
-        self.assertEqual(notice["count"], BATCHED.reopen_at_count)
-        self.assertIsNone(notice["dismissed_at"])
 
-    def test_a_notice_dismissed_past_the_count_stays_dismissed(self):
+    def test_repeats_held_from_before_an_acknowledgement_stay_hidden(self):
-        for _ in range(3):
+        self._raise_at(1000.0, "batched")
-            self.registry.raise_notice("batched")
+        self._raise_at(1005.0, "batched")
-        self.registry.flush()
+        self._acknowledge_at(1010.0, "batched")
-        self.registry.dismiss("batched")
 
-        self.registry.raise_notice("batched")
         self.registry.flush()
 
         self.assertEqual(self.registry.active(), [])
-        self.assertEqual(self.registry.active(include_dismissed=True)[0]["count"], 4)
+        self.assertEqual(self.registry.active(include_hidden=True)[0]["count"], 2)
 
     def test_keep_latest_drops_the_oldest_rows(self):
         for index, scope in enumerate(("a", "b", "c")):
@@ -438,14 +473,13 @@ class TestCatalogLifecycles(RegistryTestCase):
         ids = [n["id"] for n in self.registry.active()]
         self.assertEqual(ids, ["update_available:0.19.1"])
 
-    def test_a_dismissed_failed_login_burst_reopens_at_five_attempts(self):
+    def test_an_acknowledged_failed_login_burst_returns_on_the_next_attempt(self):
         self.registry.raise_notice("failed_login", scope="1000")
-        self.registry.dismiss("failed_login:1000")
+        self.registry.acknowledge("failed_login:1000")
 
-        for _ in range(4):
+        self.registry.raise_notice("failed_login", scope="1000")
-            self.registry.raise_notice("failed_login", scope="1000")
         self.registry.flush()
 
         burst = self.registry.active()[0]
-        self.assertEqual(burst["count"], 5)
+        self.assertEqual(burst["count"], 2)
-        self.assertIsNone(burst["dismissed_at"])
+        self.assertIsNone(burst["acknowledged_at"])

frigate/test/test_runner_devices.py

@@ -1,5 +1,7 @@
 """Tests for the device each model runner reports after loading."""
 
+import os
+import tempfile
 import threading
 import unittest
 from unittest.mock import MagicMock, patch
@@ -38,6 +40,7 @@ class TestRunnerDeviceName(unittest.TestCase):
             self._onnx(["OpenVINOExecutionProvider"]).device_name, "OpenVINO"
         )
         self.assertEqual(self._onnx(["CPUExecutionProvider"]).device_name, "CPU")
+        self.assertEqual(self._onnx(["LighterANE"]).device_name, "Neural Engine")
         self.assertEqual(self._onnx(["ROCMExecutionProvider"]).device_name, "ROCM")
         self.assertEqual(self._onnx([]).device_name, "CPU")
 
@@ -129,3 +132,147 @@ class TestLoadedDeviceSnapshot(unittest.TestCase):
         finally:
             stop.set()
             thread.join(timeout=5)
+
+
+class TestLighterANE(unittest.TestCase):
+    """lighter's plugin provider, picked up by the ONNX session setup."""
+
+    def setUp(self):
+        loaded_devices.clear()
+        self.root = tempfile.TemporaryDirectory()
+        self.addCleanup(self.root.cleanup)
+        self.library = os.path.join(self.root.name, "liblighter_ane_ep.so")
+        env = patch.dict(os.environ, {"LIGHTER_ANE_EP": self.library})
+        env.start()
+        self.addCleanup(env.stop)
+
+    def _device(self) -> MagicMock:
+        device = MagicMock()
+        device.ep_name = "LighterANE"
+        return device
+
+    def test_no_devices_without_the_library(self):
+        with patch.object(detection_runners.ort, "get_ep_devices") as get_ep_devices:
+            self.assertEqual(detection_runners.get_lighter_ane_devices(), [])
+        get_ep_devices.assert_not_called()
+
+    def test_the_provider_is_registered_once(self):
+        open(self.library, "w").close()
+        device = self._device()
+        other = MagicMock()
+        other.ep_name = "CPUExecutionProvider"
+
+        with (
+            patch.object(
+                detection_runners.ort,
+                "get_ep_devices",
+                side_effect=[[other], [other, device], [other, device]],
+            ),
+            patch.object(
+                detection_runners.ort, "register_execution_provider_library"
+            ) as register,
+        ):
+            self.assertEqual(detection_runners.get_lighter_ane_devices(), [device])
+            self.assertEqual(detection_runners.get_lighter_ane_devices(), [device])
+
+        register.assert_called_once_with("LighterANE", self.library)
+
+    def test_a_provider_that_will_not_load_is_skipped(self):
+        open(self.library, "w").close()
+
+        with (
+            patch.object(detection_runners.ort, "get_ep_devices", return_value=[]),
+            patch.object(
+                detection_runners.ort,
+                "register_execution_provider_library",
+                side_effect=RuntimeError("not a provider"),
+            ),
+        ):
+            self.assertEqual(detection_runners.get_lighter_ane_devices(), [])
+
+    def test_the_session_runs_on_the_neural_engine(self):
+        device = self._device()
+        session = MagicMock()
+        session.get_providers.return_value = ["LighterANE", "CPUExecutionProvider"]
+        options = MagicMock()
+
+        with (
+            patch.object(detection_runners, "is_rknn_compatible", return_value=False),
+            patch.object(
+                detection_runners, "get_lighter_ane_devices", return_value=[device]
+            ),
+            patch.object(
+                detection_runners, "get_ort_session_options", return_value=options
+            ),
+            patch.object(
+                detection_runners.ort, "InferenceSession", return_value=session
+            ) as inference_session,
+        ):
+            runner = get_optimized_runner("/models/yolo.onnx", "AUTO", "yolo-generic")
+
+        options.add_provider_for_devices.assert_called_once_with([device], {})
+        inference_session.assert_called_once_with(
+            "/models/yolo.onnx", sess_options=options
+        )
+        self.assertIsInstance(runner, ONNXModelRunner)
+        self.assertEqual(
+            loaded_devices["/models/yolo.onnx"], ("yolo-generic", "Neural Engine")
+        )
+
+    def test_a_model_the_neural_engine_cannot_load_uses_the_default_providers(self):
+        session = MagicMock()
+        session.get_providers.return_value = ["CPUExecutionProvider"]
+
+        with (
+            patch.object(detection_runners, "is_rknn_compatible", return_value=False),
+            patch.object(
+                detection_runners, "get_lighter_ane_devices", return_value=[MagicMock()]
+            ),
+            patch.object(
+                detection_runners,
+                "get_ort_providers",
+                return_value=(["CPUExecutionProvider"], [{}]),
+            ),
+            patch.object(
+                detection_runners, "is_openvino_gpu_npu_available", return_value=False
+            ),
+            patch.object(
+                detection_runners.ort,
+                "InferenceSession",
+                side_effect=[RuntimeError("unsupported"), session],
+            ) as inference_session,
+            patch.object(
+                detection_runners, "get_ort_session_options", return_value=MagicMock()
+            ),
+            self.assertLogs(detection_runners.logger, level="WARNING"),
+        ):
+            runner = get_optimized_runner("/models/jina.onnx", "AUTO", "jina-v2")
+
+        self.assertEqual(inference_session.call_count, 2)
+        self.assertIsInstance(runner, ONNXModelRunner)
+        self.assertEqual(loaded_devices["/models/jina.onnx"], ("jina-v2", "CPU"))
+
+    def test_a_cpu_model_stays_on_the_cpu(self):
+        session = MagicMock()
+        session.get_providers.return_value = ["CPUExecutionProvider"]
+
+        with (
+            patch.object(detection_runners, "is_rknn_compatible", return_value=False),
+            patch.object(
+                detection_runners, "get_lighter_ane_devices", return_value=[MagicMock()]
+            ) as ane,
+            patch.object(
+                detection_runners,
+                "get_ort_providers",
+                return_value=(["CPUExecutionProvider"], [{}]),
+            ),
+            patch.object(
+                detection_runners.ort, "InferenceSession", return_value=session
+            ),
+            patch.object(
+                detection_runners, "get_ort_session_options", return_value=None
+            ),
+        ):
+            get_optimized_runner("/models/arcface.onnx", "CPU", "arcface")
+
+        ane.assert_not_called()

frigate/test/test_skipped_detections.py

@@ -1,10 +1,14 @@
-"""Tests for the skipped detection rate and the notice it can raise."""
+"""Tests for the per-camera episode notices: skipped detections and high CPU."""
 
 import unittest
-from unittest.mock import patch
+from unittest.mock import call, patch
 
 from frigate.stats import emitter
-from frigate.stats.emitter import SkippedDetectionsTracker
+from frigate.stats.emitter import (
+    SKIPPED_DETECTIONS_PCT,
+    EpisodeTracker,
+    cpu_average,
+)
 from frigate.stats.util import skipped_percent
 
 
@@ -19,18 +23,18 @@ class TestSkippedPercent(unittest.TestCase):
         self.assertEqual(skipped_percent(2.0, 5.0, False), 0.0)
 
 
-class TestSkippedDetectionsTracker(unittest.TestCase):
+class TestEpisodeTracker(unittest.TestCase):
     def _cameras(self, pct: float) -> dict:
-        return {"front_door": {"skipped_pct": pct}}
+        return {"front_door": pct}
 
     def test_below_threshold_never_qualifies(self):
-        tracker = SkippedDetectionsTracker()
+        tracker = EpisodeTracker(SKIPPED_DETECTIONS_PCT)
 
         for tick in range(10):
             self.assertEqual(tracker.update(self._cameras(4.9), tick * 15.0), [])
 
     def test_qualifies_once_after_the_hold(self):
-        tracker = SkippedDetectionsTracker()
+        tracker = EpisodeTracker(SKIPPED_DETECTIONS_PCT)
 
         results = [
             tracker.update(self._cameras(10.0), tick * 15.0) for tick in range(8)
@@ -42,7 +46,7 @@ class TestSkippedDetectionsTracker(unittest.TestCase):
         self.assertEqual(results[5:], [[], [], []])
 
     def test_a_dip_restarts_the_hold(self):
-        tracker = SkippedDetectionsTracker()
+        tracker = EpisodeTracker(SKIPPED_DETECTIONS_PCT)
 
         for now, pct in ((0.0, 10.0), (15.0, 10.0), (30.0, 10.0), (45.0, 2.0)):
             self.assertEqual(tracker.update(self._cameras(pct), now), [])
@@ -51,7 +55,7 @@ class TestSkippedDetectionsTracker(unittest.TestCase):
         self.assertEqual(tracker.update(self._cameras(10.0), 120.0), ["front_door"])
 
     def test_recovery_then_relapse_is_a_new_episode(self):
-        tracker = SkippedDetectionsTracker()
+        tracker = EpisodeTracker(SKIPPED_DETECTIONS_PCT)
         tracker.update(self._cameras(10.0), 0.0)
         self.assertEqual(tracker.update(self._cameras(10.0), 60.0), ["front_door"])
 
@@ -61,17 +65,15 @@ class TestSkippedDetectionsTracker(unittest.TestCase):
         self.assertEqual(tracker.update(self._cameras(10.0), 150.0), ["front_door"])
 
     def test_cameras_are_tracked_separately(self):
-        tracker = SkippedDetectionsTracker()
+        tracker = EpisodeTracker(SKIPPED_DETECTIONS_PCT)
-        tracker.update({"a": {"skipped_pct": 10.0}, "b": {"skipped_pct": 0.0}}, 0.0)
+        tracker.update({"a": 10.0, "b": 0.0}, 0.0)
 
-        qualified = tracker.update(
+        qualified = tracker.update({"a": 10.0, "b": 10.0}, 60.0)
-            {"a": {"skipped_pct": 10.0}, "b": {"skipped_pct": 10.0}}, 60.0
-        )
 
         self.assertEqual(qualified, ["a"])
 
     def test_a_removed_camera_starts_a_new_episode(self):
-        tracker = SkippedDetectionsTracker()
+        tracker = EpisodeTracker(SKIPPED_DETECTIONS_PCT)
         tracker.update(self._cameras(10.0), 0.0)
         tracker.update({}, 15.0)
         tracker.update(self._cameras(10.0), 30.0)
@@ -79,6 +81,25 @@ class TestSkippedDetectionsTracker(unittest.TestCase):
         self.assertEqual(tracker.update(self._cameras(10.0), 60.0), [])
         self.assertEqual(tracker.update(self._cameras(10.0), 90.0), ["front_door"])
 
+    def test_a_missing_value_ends_the_episode(self):
+        tracker = EpisodeTracker(SKIPPED_DETECTIONS_PCT)
+        tracker.update(self._cameras(10.0), 0.0)
+        tracker.update({"front_door": None}, 30.0)
+
+        self.assertEqual(tracker.update(self._cameras(10.0), 60.0), [])
+
+
+class TestCpuAverage(unittest.TestCase):
+    def test_reads_the_lifetime_average(self):
+        usages = {"42": {"cpu": "80.0", "cpu_average": "25.0"}}
+
+        self.assertEqual(cpu_average(usages, 42), 25.0)
+
+    def test_unknown_process_has_no_average(self):
+        self.assertIsNone(cpu_average({}, 42))
+        self.assertIsNone(cpu_average({"42": {"cpu_average": "25.0"}}, None))
+        self.assertIsNone(cpu_average({"42": {"cpu_average": ""}}, 42))
+
 
 class TestEmitterNotices(unittest.TestCase):
     def setUp(self):
@@ -94,15 +115,25 @@ class TestEmitterNotices(unittest.TestCase):
 
     def _emitter(self) -> emitter.StatsEmitter:
         stats_emitter = emitter.StatsEmitter.__new__(emitter.StatsEmitter)
-        stats_emitter.skipped_detections = SkippedDetectionsTracker()
+        stats_emitter.skipped_detections = EpisodeTracker(SKIPPED_DETECTIONS_PCT)
+        stats_emitter.ffmpeg_cpu = EpisodeTracker(emitter.FFMPEG_HIGH_CPU_PCT)
+        stats_emitter.detect_cpu = EpisodeTracker(emitter.DETECT_HIGH_CPU_PCT)
         stats_emitter._shm_checked = False
         stats_emitter._shm_params = None
         return stats_emitter
 
-    def _stats(self, uptime: int, pct: float) -> dict:
+    def _stats(
+        self, uptime: int, pct: float, ffmpeg_cpu: str = "5.0", detect_cpu: str = "5.0"
+    ) -> dict:
         return {
             "service": {"uptime": uptime, "storage": {"/dev/shm": {}}},
-            "cameras": {"front_door": {"skipped_pct": pct}},
+            "cameras": {
+                "front_door": {"skipped_pct": pct, "ffmpeg_pid": 10, "pid": 11}
+            },
+            "cpu_usages": {
+                "10": {"cpu_average": ffmpeg_cpu},
+                "11": {"cpu_average": detect_cpu},
+            },
         }
 
     def test_qualified_camera_raises_a_notice(self):
@@ -115,6 +146,43 @@ class TestEmitterNotices(unittest.TestCase):
             "skipped_detections", scope="front_door", params={"pct": 12.5}
         )
 
+    def test_high_cpu_raises_a_notice_per_process(self):
+        stats_emitter = self._emitter()
+
+        for uptime, now in ((300, 0.0), (360, 60.0)):
+            stats_emitter._update_notices(
+                self._stats(uptime, 0.0, ffmpeg_cpu="25.0", detect_cpu="45.0"), now
+            )
+
+        self.assertEqual(
+            self.raise_notice.call_args_list,
+            [
+                call("ffmpeg_high_cpu", scope="front_door", params={"cpu": 25.0}),
+                call("detect_high_cpu", scope="front_door", params={"cpu": 45.0}),
+            ],
+        )
+
+    def test_cpu_below_each_threshold_raises_nothing(self):
+        stats_emitter = self._emitter()
+
+        for uptime, now in ((300, 0.0), (360, 60.0)):
+            stats_emitter._update_notices(
+                self._stats(uptime, 0.0, ffmpeg_cpu="19.0", detect_cpu="39.0"), now
+            )
+
+        self.raise_notice.assert_not_called()
+
+    def test_missing_cpu_stats_raise_nothing(self):
+        stats_emitter = self._emitter()
+
+        for uptime, now in ((300, 0.0), (360, 60.0)):
+            stats = self._stats(uptime, 0.0)
+            del stats["cpu_usages"]
+            stats_emitter._update_notices(stats, now)
+
+        self.raise_notice.assert_not_called()
+        self.assertEqual(self.flush_notices.call_count, 2)
+
     def test_startup_window_is_ignored(self):
         stats_emitter = self._emitter()
 

frigate/util/builtin.py

@@ -56,10 +56,13 @@ class EventsPerSecond:
             self._start = now
         # compute the (approximate) events in the last n seconds
         self.expire_timestamps(now)
-        seconds = min(now - self._start, self._last_n_seconds)
+        # rate over at least one second (or the whole window, if shorter),
-        # avoid divide by zero
+        # so a burst of events right after start() is not divided by a
-        if seconds == 0:
+        # tiny window
-            seconds = 1
+        seconds = max(
+            min(now - self._start, self._last_n_seconds),
+            min(1.0, self._last_n_seconds),
+        )
         return len(self._timestamps) / seconds
 
     # remove aged out timestamps

frigate/util/hwaccel.py

@@ -9,6 +9,7 @@ and resolve it per camera against that camera's detect stream.
 """
 
 import logging
+import os
 import re
 
 from pydantic import BaseModel, Field
@@ -23,14 +24,20 @@ from frigate.util.services import enumerate_drm_devices
 
 logger = logging.getLogger(__name__)
 
-# root the /proc reads use, so tests can point them at a fixture tree
+# roots the /proc and /sys reads use, so tests can point them at a fixture tree
 PROC_ROOT = "/proc"
+SYS_ROOT = "/sys"
 
 ANY_CODEC = "any"
 
 # a Raspberry Pi has no detection hardware of its own, so it gets a key here
 RASPBERRY_PI = "raspberrypi"
 
+# lighter (https://github.com/fieldwork-ai/lighter) decodes on a Mac's media
+# engine through virtio-media devices, which carry its virtio vendor id "LGHT"
+LIGHTER_MEDIA = "lighter"
+LIGHTER_VIRTIO_VENDOR = "0x4c474854"
+
 # ffprobe names h265 streams hevc
 CODEC_ALIASES = {"hevc": "h265"}
 
@@ -52,6 +59,7 @@ DECODE_HARDWARE = (
     "rknn",
     "openvino:GPU",
     "onnx:amd",
+    LIGHTER_MEDIA,
     RASPBERRY_PI,
 )
 
@@ -98,6 +106,10 @@ FAMILY_RPI = HwaccelFamily(
     key="rpi",
     presets={"h264": "preset-rpi-64-h264", "h265": "preset-rpi-64-h265"},
 )
+FAMILY_APPLE = HwaccelFamily(
+    key="apple-silicon",
+    presets={"h264": "preset-apple-silicon-h264", "h265": "preset-apple-silicon-h265"},
+)
 
 
 def _read(path: str) -> str | None:
@@ -139,6 +151,20 @@ def _is_raspberry_pi() -> bool:
     return "raspberrypi" in compatible
 
 
+def _has_lighter_media() -> bool:
+    video = f"{SYS_ROOT}/class/video4linux"
+
+    try:
+        devices = os.listdir(video)
+    except OSError:
+        return False
+
+    return any(
+        _read(f"{video}/{device}/device/vendor") == LIGHTER_VIRTIO_VENDOR
+        for device in devices
+    )
+
+
 def _intel_families(generation: int | None) -> list[HwaccelFamily]:
     """vaapi drives every Intel GPU, qsv only those from gen8 on."""
     if generation is not None and generation < INTEL_QSV_SUPPORTED_GEN:
@@ -164,6 +190,9 @@ def _families(key: str, generation: int | None) -> list[HwaccelFamily]:
     if key == "onnx:amd":
         return [FAMILY_VAAPI]
 
+    if key == LIGHTER_MEDIA:
+        return [FAMILY_APPLE]
+
     if key == RASPBERRY_PI:
         return [FAMILY_RPI]
 
@@ -193,6 +222,9 @@ def _decode_hardware(detector_key: str | None) -> list[str]:
     """
     present = {found.key for found in hardware_prober.probe()}
 
+    if _has_lighter_media():
+        present.add(LIGHTER_MEDIA)
+
     if _is_raspberry_pi():
         present.add(RASPBERRY_PI)
 

frigate/util/live_streams.py

@@ -0,0 +1,216 @@
+"""Frigate-managed go2rtc live streams: transcoded rungs and bitrate probes."""
+
+import logging
+import re
+import time
+from typing import TYPE_CHECKING, Any
+
+import requests
+
+if TYPE_CHECKING:
+    from frigate.config import FrigateConfig
+
+logger = logging.getLogger(__name__)
+
+GO2RTC_API = "http://127.0.0.1:1984/api"
+
+DEFAULT_TRANSCODE_QUALITIES: list[dict[str, int]] = [
+    {"height": 720, "bitrate": 1200},
+    {"height": 480, "bitrate": 500},
+    {"height": 360, "bitrate": 250},
+]
+
+
+def transcode_stream_name(camera: str, height: int) -> str:
+    """Return the go2rtc name of a camera's transcoded stream at one height."""
+    return f"{camera}_transcode_{height}p"
+
+
+def is_transcode_stream_name(camera: str, name: str) -> bool:
+    """Return whether a stream name follows this camera's transcoded naming."""
+    return re.fullmatch(rf"{re.escape(camera)}_transcode_\d+p", name) is not None
+
+
+def transcode_stream_source(source: str, height: int, bitrate: int) -> str:
+    """Build the go2rtc ffmpeg source that transcodes a stream to H.264.
+
+    go2rtc rejects API-registered sources containing spaces, so each ffmpeg
+    token gets its own #raw= parameter. #audio=copy keeps audio, which any
+    #video= option would otherwise drop.
+    """
+    tokens = (
+        "-b:v",
+        f"{bitrate}k",
+        "-maxrate",
+        f"{bitrate}k",
+        "-bufsize",
+        f"{2 * bitrate}k",
+    )
+    raw = "".join(f"#raw={token}" for token in tokens)
+    return f"ffmpeg:{source}#video=h264#height={height}#hardware#audio=copy{raw}"
+
+
+def transcode_streams(
+    camera: str, source: str, qualities: list[dict[str, int]]
+) -> dict[str, str]:
+    """Map each quality's go2rtc stream name to its source."""
+    return {
+        transcode_stream_name(camera, quality["height"]): transcode_stream_source(
+            source, quality["height"], quality["bitrate"]
+        )
+        for quality in qualities
+    }
+
+
+def default_transcode_source(camera: str, streams: dict[str, str]) -> str | None:
+    """Return the first live stream that is not itself transcoded."""
+    return next(
+        (
+            name
+            for name in streams.values()
+            if not is_transcode_stream_name(camera, name)
+        ),
+        None,
+    )
+
+
+def raw_transcode_streams(config: dict[str, Any]) -> dict[str, str]:
+    """Build transcoded go2rtc streams for every enabled camera in a raw config.
+
+    go2rtc's config is written before FrigateConfig validation runs, so this
+    resolves defaults the same way the validator does.
+    """
+    streams: dict[str, str] = {}
+
+    for camera, camera_config in (config.get("cameras") or {}).items():
+        live = (camera_config or {}).get("live") or {}
+        transcode = live.get("transcode") or {}
+
+        if not transcode.get("enabled"):
+            continue
+
+        source = transcode.get("source") or default_transcode_source(
+            camera, live.get("streams") or {camera: camera}
+        )
+
+        if source is None:
+            continue
+
+        qualities = transcode.get("qualities")
+
+        if qualities is None:
+            qualities = DEFAULT_TRANSCODE_QUALITIES
+
+        # malformed entries fail Frigate's validation; skipping them here keeps
+        # go2rtc from crash-looping alongside it
+        valid = [
+            quality
+            for quality in (qualities if isinstance(qualities, list) else [])
+            if isinstance(quality, dict)
+            and "height" in quality
+            and "bitrate" in quality
+        ]
+        streams.update(transcode_streams(camera, source, valid))
+
+    return streams
+
+
+def generated_transcode_streams(config: "FrigateConfig") -> dict[str, str]:
+    """Build transcoded go2rtc streams for every enabled camera."""
+    streams: dict[str, str] = {}
+
+    for camera in config.cameras.values():
+        transcode = camera.live.transcode
+
+        if transcode.enabled and transcode.source:
+            streams.update(
+                transcode_streams(
+                    camera.name,
+                    transcode.source,
+                    [quality.model_dump() for quality in transcode.qualities],
+                )
+            )
+
+    return streams
+
+
+def _go2rtc_streams_call(method: str, name: str, params: dict[str, str]) -> bool:
+    try:
+        response = requests.request(
+            method, f"{GO2RTC_API}/streams", params=params, timeout=5
+        )
+    except requests.RequestException as e:
+        logger.error("Failed to sync go2rtc stream %s: %s", name, e)
+        return False
+
+    if not response.ok:
+        logger.error("Failed to sync go2rtc stream %s: %s", name, response.text)
+        return False
+
+    return True
+
+
+def sync_transcode_streams(old: dict[str, str], new: dict[str, str]) -> bool:
+    """Register added or changed streams with go2rtc and remove dropped ones.
+
+    Returns False when any go2rtc call failed.
+    """
+    ok = True
+
+    for name, source in new.items():
+        if old.get(name) != source:
+            ok = _go2rtc_streams_call("put", name, {"name": name, "src": source}) and ok
+
+    for name in old.keys() - new.keys():
+        ok = _go2rtc_streams_call("delete", name, {"src": name}) and ok
+
+    return ok
+
+
+def measure_stream_bitrate(
+    name: str, duration: float = 6.0, warmup: float = 1.0
+) -> float | None:
+    """Measure a go2rtc stream's average kbps from its local MP4 output.
+
+    The first warmup seconds after the first byte are skipped so the startup
+    keyframe burst does not inflate the result. Returns None when the stream
+    sends nothing.
+    """
+    first = start = now = None
+    counted = 0
+
+    try:
+        with requests.get(
+            f"{GO2RTC_API}/stream.mp4",
+            params={"src": name},
+            stream=True,
+            timeout=5,
+        ) as response:
+            if not response.ok:
+                return None
+
+            for chunk in response.iter_content(chunk_size=16384):
+                now = time.monotonic()
+
+                if first is None:
+                    first = now
+
+                if now - first < warmup:
+                    continue
+
+                if start is None:
+                    start = now
+                    continue
+
+                counted += len(chunk)
+
+                if now - start >= duration:
+                    break
+    except requests.RequestException as e:
+        logger.warning("Failed to measure go2rtc stream %s: %s", name, e)
+        return None
+
+    if start is None or now is None or now <= start or counted == 0:
+        return None
+
+    return counted * 8 / 1000 / (now - start)

generate_analytics_schema.py

@@ -1,59 +0,0 @@
-"""Generate the analytics report JSON Schema from the Pydantic models.
-
-The committed docs/static/frigate-analytics-schema.json documents every field
-for the ingest Worker's aggregation job and the docs page. It is exact for this
-version only, so the Worker validates just the envelope against it. Never edit
-it by hand, and never run a formatter over it.
-
-Usage (from the repository root):
-
-    python3 generate_analytics_schema.py            # write the schema
-    python3 generate_analytics_schema.py --check    # CI guard: fail if stale
-"""
-
-import argparse
-import json
-import sys
-from pathlib import Path
-
-from frigate.analytics.schema import SCHEMA_VERSION, AnalyticsReport
-
-OUTPUT = Path(__file__).parent / "docs" / "static" / "frigate-analytics-schema.json"
-
-
-def render() -> str:
-    schema = AnalyticsReport.model_json_schema()
-    schema["$schema"] = "https://json-schema.org/draft/2020-12/schema"
-    schema["$id"] = "https://docs.frigate.video/frigate-analytics-schema.json"
-    schema["x-schema-version"] = SCHEMA_VERSION
-    return json.dumps(schema, indent=2, sort_keys=True) + "\n"
-
-
-def main() -> int:
-    parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
-    parser.add_argument(
-        "--check", action="store_true", help="fail if the committed schema is stale"
-    )
-    args = parser.parse_args()
-    rendered = render()
-
-    if args.check:
-        current = OUTPUT.read_text() if OUTPUT.exists() else ""
-
-        if current != rendered:
-            print(
-                f"{OUTPUT} is out of date, run python3 generate_analytics_schema.py",
-                file=sys.stderr,
-            )
-            return 1
-
-        print(f"{OUTPUT} is up to date")
-        return 0
-
-    OUTPUT.write_text(rendered)
-    print(f"Wrote {OUTPUT}")
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())

generate_api_auth_spec.py

@@ -47,8 +47,8 @@ from fastapi.routing import APIRoute
 from ruamel.yaml import YAML
 from ruamel.yaml.scalarstring import LiteralScalarString
 
+from frigate.api import app as main_app
 from frigate.api import (
-    analytics,
     auth,
     camera,
     chat,
@@ -65,7 +65,6 @@ from frigate.api import (
     record,
     review,
 )
-from frigate.api import app as main_app
 from frigate.api.auth import require_admin_by_default
 
 logging.basicConfig(level=logging.INFO, format="%(message)s")
@@ -146,7 +145,6 @@ def build_app() -> FastAPI:
     """
     app = FastAPI()
     routers = [
-        analytics.router,
         auth.router,
         camera.router,
         chat.router,

migrations/038_create_notices.py

@@ -18,18 +18,21 @@ def migrate(migrator, database, fake=False, **kwargs):
         '"first_seen" DATETIME NOT NULL, '
         '"last_seen" DATETIME NOT NULL, '
         '"count" INTEGER NOT NULL, '
-        '"dismissed_at" DATETIME)'
+        '"acknowledged_at" DATETIME, '
+        '"muted_at" DATETIME)'
     )
     migrator.sql('CREATE INDEX IF NOT EXISTS "notice_kind" ON "notice" ("kind")')
     migrator.sql(
         'CREATE TABLE IF NOT EXISTS "noticestats" ('
         '"kind" VARCHAR(50) NOT NULL PRIMARY KEY, '
         '"occurrences" INTEGER NOT NULL, '
-        '"dismissals" INTEGER NOT NULL, '
+        '"acknowledgements" INTEGER NOT NULL, '
+        '"mutes" INTEGER NOT NULL, '
         '"first_seen" DATETIME NOT NULL, '
         '"last_seen" DATETIME NOT NULL, '
         '"reported_occurrences" INTEGER NOT NULL DEFAULT 0, '
-        '"reported_dismissals" INTEGER NOT NULL DEFAULT 0)'
+        '"reported_acknowledgements" INTEGER NOT NULL DEFAULT 0, '
+        '"reported_mutes" INTEGER NOT NULL DEFAULT 0)'
     )
 
 

web/e2e/helpers/api-mocker.ts

@@ -49,7 +49,7 @@ export interface ApiMockOverrides {
   };
   users?: { username: string; role: string }[];
   notices?: unknown[];
-  dismissedChecks?: unknown[];
+  mutedChecks?: unknown[];
   /** camera name to the ffprobe entries returned for `paths=camera:<name>` */
   ffprobe?: Record<string, unknown[]>;
 }
@@ -238,8 +238,8 @@ export class ApiMocker {
     await this.page.route("**/api/notices", (route) =>
       route.fulfill({ json: overrides?.notices ?? [] }),
     );
-    await this.page.route("**/api/notices/dismissed_checks", (route) =>
+    await this.page.route("**/api/notices/muted_checks", (route) =>
-      route.fulfill({ json: overrides?.dismissedChecks ?? [] }),
+      route.fulfill({ json: overrides?.mutedChecks ?? [] }),
     );
 
     // Users. GET lists them; POST/PUT (create, password) just succeed, so

web/e2e/specs/live-auto-stream.spec.ts

@@ -0,0 +1,320 @@
+/**
+ * Auto live stream selection in the single-camera view.
+ *
+ * go2rtc is mocked per stream. A failing stream answers MSE codec
+ * negotiation with go2rtc's "codecs not matched" error, the one ladder
+ * trigger Chromium reproduces without real media. A healthy stream
+ * answers negotiation and then sends nothing, so it waits quietly.
+ */
+import type { Locator, Page } from "@playwright/test";
+import { test, expect } from "../fixtures/frigate-test";
+import { LivePage } from "../pages/live.page";
+
+// the mocked profile is admin, so useUserPersistence keys are namespaced
+const STREAM_KEY = "front_door-stream:admin";
+const CODEC_ERROR = "mse: streams: codecs not matched: H265 => H264";
+
+const CONFIG = {
+  go2rtc: {
+    streams: {
+      front_door: ["rtsp://127.0.0.1:8554/front_door"],
+      front_door_sub: ["rtsp://127.0.0.1:8554/front_door_sub"],
+      backyard: ["rtsp://127.0.0.1:8554/backyard"],
+    },
+    webrtc: { candidates: [], ice_servers: [] },
+  },
+  cameras: {
+    front_door: {
+      live: { streams: { Sub: "front_door_sub" } },
+    },
+  },
+};
+
+test.use({ expectedErrors: [/MSE error 'mse-codec'/] });
+
+async function writeIdb(page: Page, entries: Record<string, unknown>) {
+  await page.evaluate(async (data) => {
+    await new Promise<void>((resolve, reject) => {
+      const request = indexedDB.open("keyval-store", 1);
+      request.onupgradeneeded = () =>
+        request.result.createObjectStore("keyval");
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => {
+        const tx = request.result.transaction("keyval", "readwrite");
+        const store = tx.objectStore("keyval");
+        Object.entries(data).forEach(([key, value]) => store.put(value, key));
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => reject(tx.error);
+      };
+    });
+  }, entries);
+}
+
+async function readIdb(page: Page, key: string) {
+  return page.evaluate(async (target) => {
+    return new Promise((resolve, reject) => {
+      const request = indexedDB.open("keyval-store", 1);
+      request.onupgradeneeded = () =>
+        request.result.createObjectStore("keyval");
+      request.onerror = () => reject(request.error);
+      request.onsuccess = () => {
+        const tx = request.result.transaction("keyval", "readonly");
+        const get = tx.objectStore("keyval").get(target);
+        get.onsuccess = () => resolve(get.result ?? null);
+        get.onerror = () => reject(get.error);
+      };
+    });
+  }, key);
+}
+
+// records the src of every MSE socket in open order
+async function mockGo2rtc(page: Page, failing: string[] = []) {
+  const opened: string[] = [];
+
+  await page.routeWebSocket("**/live/mse/api/ws**", (ws) => {
+    const src = new URL(ws.url()).searchParams.get("src") ?? "";
+    opened.push(src);
+
+    ws.onMessage((message) => {
+      const msg = JSON.parse(message.toString());
+      if (msg.type !== "mse") {
+        return;
+      }
+
+      ws.send(
+        JSON.stringify(
+          failing.includes(src)
+            ? { type: "error", value: CODEC_ERROR }
+            : { type: "mse", value: 'video/mp4; codecs="avc1.640029"' },
+        ),
+      );
+    });
+  });
+
+  await page.route("**/api/go2rtc/streams/**", (route) =>
+    route.fulfill({
+      json: {
+        producers: [{ medias: ["video, recvonly, H264"] }],
+        consumers: [],
+      },
+    }),
+  );
+
+  return opened;
+}
+
+async function openDesktopSettings(page: Page) {
+  const live = new LivePage(page, true);
+  await expect(live.backButton).toBeVisible({ timeout: 10_000 });
+  await page.locator("button:has(svg)").last().click();
+  const menu = page.locator('[role="menu"], [data-radix-menu-content]').first();
+  await expect(menu).toBeVisible({ timeout: 3_000 });
+  return menu;
+}
+
+function streamTrigger(menu: Locator) {
+  return menu
+    .locator('div:has(> label[for="streaming-method"]) [role="combobox"]')
+    .first();
+}
+
+test.describe("Auto live stream @mobile", () => {
+  test("a codec error on the main stream moves Auto to the sub stream", async ({
+    frigateApp,
+  }) => {
+    await frigateApp.installDefaults({ config: CONFIG });
+    const opened = await mockGo2rtc(frigateApp.page, ["front_door"]);
+
+    await frigateApp.goto("/#front_door");
+
+    await expect
+      .poll(() => opened, { timeout: 10_000 })
+      .toContain("front_door_sub");
+    expect(opened[0]).toBe("front_door");
+  });
+});
+
+test.describe("Transcoded live stream @mobile", () => {
+  test("a pinned transcoded stream plays over MSE", async ({ frigateApp }) => {
+    // go2rtc.streams lists only yaml streams; transcoded ones are generated
+    await frigateApp.installDefaults({
+      config: {
+        ...CONFIG,
+        cameras: {
+          front_door: {
+            live: {
+              streams: {
+                Sub: "front_door_sub",
+                "720p": "front_door_transcode_720p",
+              },
+              transcode: {
+                enabled: true,
+                source: "front_door",
+                qualities: [{ height: 720, bitrate: 1200 }],
+              },
+            },
+          },
+        },
+      },
+    });
+    const opened = await mockGo2rtc(frigateApp.page);
+
+    await frigateApp.goto("/");
+    await writeIdb(frigateApp.page, {
+      [STREAM_KEY]: "front_door_transcode_720p",
+    });
+    await frigateApp.goto("/#front_door");
+
+    await expect
+      .poll(() => opened, { timeout: 10_000 })
+      .toContain("front_door_transcode_720p");
+  });
+});
+
+test.describe("Auto live stream selector", () => {
+  test.beforeEach(({ frigateApp }) => {
+    test.skip(frigateApp.isMobile, "Desktop dropdown only");
+  });
+
+  test("no saved stream opens Auto on the first stream", async ({
+    frigateApp,
+  }) => {
+    await frigateApp.installDefaults({ config: CONFIG });
+    const opened = await mockGo2rtc(frigateApp.page);
+
+    await frigateApp.goto("/#front_door");
+
+    await expect.poll(() => opened[0], { timeout: 10_000 }).toBe("front_door");
+    const menu = await openDesktopSettings(frigateApp.page);
+    await expect(streamTrigger(menu)).toHaveText("Auto · front_door");
+  });
+
+  test("a codec error shows the codec reason", async ({ frigateApp }) => {
+    await frigateApp.installDefaults({ config: CONFIG });
+    const opened = await mockGo2rtc(frigateApp.page, ["front_door"]);
+
+    await frigateApp.goto("/#front_door");
+
+    await expect
+      .poll(() => opened, { timeout: 10_000 })
+      .toContain("front_door_sub");
+    const menu = await openDesktopSettings(frigateApp.page);
+    await expect(streamTrigger(menu)).toHaveText("Auto · Sub");
+    await expect(
+      menu.getByText(/because this browser can't play a higher-quality stream/),
+    ).toBeVisible();
+  });
+
+  test("trying the highest quality retries the top stream", async ({
+    frigateApp,
+  }) => {
+    await frigateApp.installDefaults({ config: CONFIG });
+    const opened = await mockGo2rtc(frigateApp.page, ["front_door"]);
+
+    await frigateApp.goto("/#front_door");
+
+    await expect
+      .poll(() => opened, { timeout: 10_000 })
+      .toContain("front_door_sub");
+    const menu = await openDesktopSettings(frigateApp.page);
+    const beforeRetry = opened.length;
+    await menu.getByRole("button", { name: "Try highest quality" }).click();
+
+    await expect
+      .poll(() => opened.slice(beforeRetry), { timeout: 10_000 })
+      .toContain("front_door");
+  });
+
+  test("a pinned main takes the legacy fallback instead of stepping down", async ({
+    frigateApp,
+  }) => {
+    await frigateApp.installDefaults({ config: CONFIG });
+    const opened = await mockGo2rtc(frigateApp.page, ["front_door"]);
+
+    await frigateApp.goto("/");
+    await writeIdb(frigateApp.page, { [STREAM_KEY]: "front_door" });
+    await frigateApp.goto("/#front_door");
+
+    const menu = await openDesktopSettings(frigateApp.page);
+    await expect(
+      menu.getByText(/Live view is in low-bandwidth mode/),
+    ).toBeVisible({ timeout: 10_000 });
+    expect(opened).not.toContain("front_door_sub");
+  });
+
+  test("selecting Auto clears the saved stream", async ({ frigateApp }) => {
+    await frigateApp.installDefaults({ config: CONFIG });
+    await mockGo2rtc(frigateApp.page);
+
+    await frigateApp.goto("/");
+    await writeIdb(frigateApp.page, { [STREAM_KEY]: "front_door_sub" });
+    await frigateApp.goto("/#front_door");
+
+    const menu = await openDesktopSettings(frigateApp.page);
+    await expect(streamTrigger(menu)).toHaveText("Sub");
+    await streamTrigger(menu).click();
+    await frigateApp.page.getByRole("option", { name: /^Auto/ }).click();
+
+    await expect.poll(() => readIdb(frigateApp.page, STREAM_KEY)).toBeNull();
+  });
+
+  test("a stale pin falls back to Auto", async ({ frigateApp }) => {
+    await frigateApp.installDefaults({ config: CONFIG });
+    const opened = await mockGo2rtc(frigateApp.page);
+
+    await frigateApp.goto("/");
+    await writeIdb(frigateApp.page, { [STREAM_KEY]: "removed_stream" });
+    await frigateApp.goto("/#front_door");
+
+    await expect.poll(() => readIdb(frigateApp.page, STREAM_KEY)).toBeNull();
+    await expect.poll(() => opened[0], { timeout: 10_000 }).toBe("front_door");
+  });
+
+  test("a single-stream camera offers no Auto", async ({ frigateApp }) => {
+    await frigateApp.installDefaults({ config: CONFIG });
+    await mockGo2rtc(frigateApp.page);
+
+    await frigateApp.goto("/#backyard");
+
+    const menu = await openDesktopSettings(frigateApp.page);
+    await streamTrigger(menu).click();
+    await expect(
+      frigateApp.page.getByRole("option", { name: "backyard" }),
+    ).toBeVisible();
+    await expect(
+      frigateApp.page.getByRole("option", { name: /^Auto/ }),
+    ).toHaveCount(0);
+  });
+
+  test("Reset stream at the floor returns to the top stream", async ({
+    frigateApp,
+  }) => {
+    await frigateApp.installDefaults({ config: CONFIG });
+    const opened = await mockGo2rtc(frigateApp.page, [
+      "front_door",
+      "front_door_sub",
+    ]);
+
+    await frigateApp.goto("/#front_door");
+
+    await expect
+      .poll(() => opened, { timeout: 10_000 })
+      .toContain("front_door_sub");
+    expect(opened[0]).toBe("front_door");
+
+    const menu = await openDesktopSettings(frigateApp.page);
+    await expect(streamTrigger(menu)).toHaveText("Auto · Low bandwidth");
+    await expect(
+      menu.getByText(/Playing the low-bandwidth feed/),
+    ).toBeVisible();
+
+    const beforeReset = opened.length;
+    await menu.getByRole("button", { name: "Reset stream" }).click();
+
+    // leaving the floor changes the stream and the mode in one render,
+    // which must still open each stream exactly once
+    await expect
+      .poll(() => opened.slice(beforeReset), { timeout: 10_000 })
+      .toEqual(["front_door", "front_door_sub"]);
+  });
+});

web/e2e/specs/settings/camera-live-transcode.spec.ts

@@ -0,0 +1,254 @@
+/**
+ * Live playback stream order and transcoded streams -- MEDIUM tier.
+ *
+ * The stream list order is the Auto ladder, so the form saves it with
+ * replace_paths. Transcoded streams are generated from live.transcode and
+ * appear in the list as soon as the switch flips.
+ */
+
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { test, expect } from "../../fixtures/frigate-test";
+import type { Page } from "@playwright/test";
+import { configFactory } from "../../fixtures/mock-data/config";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const CONFIG_SCHEMA = JSON.parse(
+  readFileSync(
+    resolve(__dirname, "../../fixtures/mock-data/config-schema.json"),
+    "utf-8",
+  ),
+);
+
+const GO2RTC_STREAMS = {
+  front_door_main: ["rtsp://user:pass@192.168.0.20:554/main"],
+  front_door_sub: ["rtsp://user:pass@192.168.0.20:554/sub"],
+};
+
+const TRANSCODE = {
+  enabled: false,
+  qualities: [
+    { height: 720, bitrate: 1200 },
+    { height: 480, bitrate: 500 },
+  ],
+};
+
+const SETTINGS_URL = "/settings?page=cameraLivePlayback&camera=front_door";
+
+type RouteOptions = {
+  go2rtcStreams?: Record<string, string[]>;
+  streams?: Record<string, string>;
+  bitrates?: Record<string, number>;
+};
+
+async function installRoutes(page: Page, options: RouteOptions = {}) {
+  const go2rtcStreams = options.go2rtcStreams ?? GO2RTC_STREAMS;
+  const streams = options.streams ?? {
+    Sub: "front_door_sub",
+    Main: "front_door_main",
+  };
+  const live = { streams, transcode: TRANSCODE };
+  const config = configFactory({
+    go2rtc: { streams: go2rtcStreams },
+    cameras: { front_door: { live } },
+  });
+  // configFactory's deepMerge adds override keys onto the base fixture's
+  // streams map instead of replacing it (they share no key names here), so
+  // pin the streams map to exactly what this test wants.
+  config.cameras.front_door.live.streams = streams;
+
+  let lastSaved: Record<string, unknown> | null = null;
+
+  await page.route("**/api/config/schema.json", (route) =>
+    route.fulfill({ json: CONFIG_SCHEMA }),
+  );
+  await page.route("**/api/config", (route) => {
+    if (route.request().method() === "GET") {
+      return route.fulfill({ json: config });
+    }
+    return route.fulfill({ json: { success: true } });
+  });
+  await page.route("**/api/config/raw_paths", (route) =>
+    route.fulfill({
+      json: {
+        go2rtc: { streams: go2rtcStreams },
+        cameras: { front_door: { live } },
+      },
+    }),
+  );
+  await page.route("**/api/config/set", async (route) => {
+    lastSaved = route.request().postDataJSON();
+    await route.fulfill({ json: { success: true, go2rtc_synced: true } });
+  });
+  await page.route("**/api/go2rtc/streams/*/bitrate", (route) => {
+    const name = decodeURIComponent(
+      new URL(route.request().url()).pathname.split("/").slice(-2)[0],
+    );
+    const kbps = options.bitrates?.[name];
+    return kbps === undefined
+      ? route.fulfill({ status: 502, json: { success: false } })
+      : route.fulfill({ json: { success: true, kbps } });
+  });
+
+  return { saved: () => lastSaved };
+}
+
+function streamNames(page: Page) {
+  return page
+    .getByRole("textbox", { name: "Stream name" })
+    .evaluateAll((inputs) =>
+      inputs.map((input) => (input as HTMLInputElement).value),
+    );
+}
+
+async function dragRow(page: Page, from: number, to: number) {
+  const handles = page.getByRole("button", { name: "Drag to reorder" });
+  const start = await handles.nth(from).boundingBox();
+  const end = await handles.nth(to).boundingBox();
+
+  if (!start || !end) throw new Error("drag handle not visible");
+
+  await page.mouse.move(start.x + start.width / 2, start.y + start.height / 2);
+  await page.mouse.down();
+  await page.mouse.move(
+    end.x + end.width / 2,
+    end.y + end.height / 2 + (to > from ? 12 : -12),
+    { steps: 15 },
+  );
+  await page.mouse.up();
+}
+
+test.describe("live stream order and transcoded streams @medium", () => {
+  test.skip(({ frigateApp }) => frigateApp.isMobile, "desktop drag");
+
+  test("dragging a stream saves the new order", async ({ frigateApp }) => {
+    const capture = await installRoutes(frigateApp.page);
+    await frigateApp.goto(SETTINGS_URL);
+
+    await expect
+      .poll(() => streamNames(frigateApp.page))
+      .toEqual(["Sub", "Main"]);
+
+    await dragRow(frigateApp.page, 1, 0);
+    await expect
+      .poll(() => streamNames(frigateApp.page))
+      .toEqual(["Main", "Sub"]);
+
+    await frigateApp.page.getByRole("button", { name: "Save" }).click();
+
+    await expect.poll(() => capture.saved()).not.toBeNull();
+    const saved = capture.saved() as {
+      replace_paths: string[];
+      config_data: {
+        cameras: { front_door: { live: { streams: Record<string, string> } } };
+      };
+    };
+    expect(saved.replace_paths).toEqual(["cameras.front_door.live.streams"]);
+    expect(
+      Object.keys(saved.config_data.cameras.front_door.live.streams),
+    ).toEqual(["Main", "Sub"]);
+  });
+
+  test("enabling transcoding saves the shown source", async ({
+    frigateApp,
+  }) => {
+    const capture = await installRoutes(frigateApp.page);
+    await frigateApp.goto(SETTINGS_URL);
+
+    await frigateApp.page
+      .getByRole("switch", { name: "Enable transcoded streams" })
+      .click();
+    await frigateApp.page.getByRole("button", { name: "Save" }).click();
+
+    await expect.poll(() => capture.saved()).not.toBeNull();
+    const saved = capture.saved() as {
+      config_data: {
+        cameras: {
+          front_door: { live: { transcode: Record<string, unknown> } };
+        };
+      };
+    };
+    // pinned, so dragging another stream to the top can't change it
+    expect(saved.config_data.cameras.front_door.live.transcode).toMatchObject({
+      enabled: true,
+      source: "front_door_sub",
+    });
+  });
+
+  test("the transcode switch adds and removes transcoded rows", async ({
+    frigateApp,
+  }) => {
+    await installRoutes(frigateApp.page);
+    await frigateApp.goto(SETTINGS_URL);
+
+    const toggle = frigateApp.page.getByRole("switch", {
+      name: "Enable transcoded streams",
+    });
+    const save = frigateApp.page.getByRole("button", { name: "Save" });
+
+    await toggle.click();
+    await expect
+      .poll(() => streamNames(frigateApp.page))
+      .toEqual(["Sub", "Main", "720p", "480p"]);
+    await expect(
+      frigateApp.page.getByText("Transcoded", { exact: true }),
+    ).toHaveCount(2);
+    await expect(save).toBeEnabled();
+
+    await toggle.click();
+    await expect
+      .poll(() => streamNames(frigateApp.page))
+      .toEqual(["Sub", "Main"]);
+    await expect(save).toBeDisabled();
+  });
+
+  test("auto order sorts measured and set bitrates", async ({ frigateApp }) => {
+    await installRoutes(frigateApp.page, {
+      bitrates: { front_door_main: 4000, front_door_sub: 800 },
+    });
+    await frigateApp.goto(SETTINGS_URL);
+
+    await frigateApp.page
+      .getByRole("switch", { name: "Enable transcoded streams" })
+      .click();
+    await frigateApp.page.getByRole("button", { name: "Auto order" }).click();
+
+    await expect
+      .poll(() => streamNames(frigateApp.page))
+      .toEqual(["Main", "720p", "Sub", "480p"]);
+    await expect(frigateApp.page.getByText("4000 kbps")).toBeVisible();
+    await expect(frigateApp.page.getByText("1200 kbps (set)")).toBeVisible();
+  });
+
+  test("an unmeasurable stream sorts last", async ({ frigateApp }) => {
+    await installRoutes(frigateApp.page, {
+      bitrates: { front_door_main: 4000 },
+    });
+    await frigateApp.goto(SETTINGS_URL);
+
+    await frigateApp.page.getByRole("button", { name: "Auto order" }).click();
+
+    await expect
+      .poll(() => streamNames(frigateApp.page))
+      .toEqual(["Main", "Sub"]);
+    await expect(frigateApp.page.getByText("Couldn't measure")).toBeVisible();
+  });
+
+  test("transcoding needs a go2rtc stream", async ({ frigateApp }) => {
+    await installRoutes(frigateApp.page, {
+      go2rtcStreams: {},
+      streams: { front_door: "front_door" },
+    });
+    await frigateApp.goto(SETTINGS_URL);
+
+    await expect(
+      frigateApp.page.getByRole("switch", {
+        name: "Enable transcoded streams",
+      }),
+    ).toBeDisabled();
+    await expect(
+      frigateApp.page.getByText(/need a go2rtc stream to read from/),
+    ).toBeVisible();
+  });
+});

web/e2e/specs/settings/telemetry-analytics.spec.ts

@@ -1,54 +0,0 @@
-/**
- * Telemetry settings: the analytics preview shows the report Frigate would
- * send, fetched only when opened.
- */
-
-import { readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { test, expect } from "../../fixtures/frigate-test";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const CONFIG_SCHEMA = JSON.parse(
-  readFileSync(
-    resolve(__dirname, "../../fixtures/mock-data/config-schema.json"),
-    "utf-8",
-  ),
-);
-
-const PREVIEW = {
-  schema_version: 1,
-  install_id: "0".repeat(32),
-  install: { version: "0.19.0-test" },
-};
-
-test.describe("telemetry settings: analytics preview @medium", () => {
-  test("shows the report on demand", async ({ frigateApp }) => {
-    let requests = 0;
-    const page = frigateApp.page;
-
-    await page.route("**/api/config/schema.json", (route) =>
-      route.fulfill({ json: CONFIG_SCHEMA }),
-    );
-    await page.route("**/api/config/raw_paths", (route) =>
-      route.fulfill({ json: { telemetry: {} } }),
-    );
-    await page.route("**/api/analytics/preview", (route) => {
-      requests += 1;
-      return route.fulfill({ json: PREVIEW });
-    });
-
-    await frigateApp.goto("/settings?page=systemTelemetry");
-
-    const button = page.getByRole("button", { name: "Preview the report" });
-    await expect(button).toBeVisible();
-    expect(requests).toBe(0);
-
-    await button.click();
-
-    await expect(page.getByTestId("analytics-preview")).toContainText(
-      '"schema_version": 1',
-    );
-    expect(requests).toBe(1);
-  });
-});

web/e2e/specs/system-health.spec.ts

@@ -1,7 +1,8 @@
 /**
  * Health tab tests -- MEDIUM tier.
  *
- * Default tab, notice list rendering, dismiss, empty state, update notice.
+ * Default tab, notice list rendering, acknowledge and mute, empty state,
+ * update notice.
  */
 
 import { test, expect } from "../fixtures/frigate-test";
@@ -23,7 +24,9 @@ const ERROR_NOTICE = {
   first_seen: NOW - 600,
   last_seen: NOW,
   count: 2,
-  dismissed_at: null,
+  acknowledgeable: true,
+  acknowledged_at: null,
+  muted_at: null,
 };
 
 const EVENT_NOTICE = {
@@ -37,7 +40,9 @@ const EVENT_NOTICE = {
   first_seen: NOW - 7200,
   last_seen: NOW - 60,
   count: 3,
-  dismissed_at: null,
+  acknowledgeable: true,
+  acknowledged_at: null,
+  muted_at: null,
 };
 
 test.describe("System — Health tab @medium", () => {
@@ -63,54 +68,61 @@ test.describe("System — Health tab @medium", () => {
       "Downloading model.onnx for yolo failed: timeout",
     );
     await expect(rows.nth(0)).toContainText("2 times");
-    await expect(
-      rows.nth(0).getByRole("button", { name: "Dismiss" }),
-    ).toBeVisible();
     await expect(rows.nth(1)).toContainText("Detector ov was restarted");
     await expect(rows.nth(1)).toContainText("3 times");
-    await expect(
+    for (const index of [0, 1]) {
-      rows.nth(1).getByRole("button", { name: "Dismiss" }),
+      await expect(
-    ).toBeVisible();
+        rows.nth(index).getByRole("button", { name: "Acknowledge" }),
+      ).toBeVisible();
+      await expect(
+        rows.nth(index).getByRole("button", { name: "Mute", exact: true }),
+      ).toBeVisible();
+    }
   });
 
-  test("dismiss posts and removes the row", async ({ frigateApp }) => {
+  for (const action of ["acknowledge", "mute"] as const) {
-    await frigateApp.installDefaults({
+    test(`${action} posts and removes the row`, async ({ frigateApp }) => {
-      stats: QUIET_STATS,
+      await frigateApp.installDefaults({
-      notices: [EVENT_NOTICE],
+        stats: QUIET_STATS,
+        notices: [EVENT_NOTICE],
+      });
+
+      // the list shrinks after the POST so the refetch shows the row gone
+      let hidden = false;
+      await frigateApp.page.route("**/api/notices", (route) =>
+        route.fulfill({ json: hidden ? [] : [EVENT_NOTICE] }),
+      );
+      await frigateApp.page.route(
+        `**/api/notices/detector_stuck/${action}`,
+        (route) => {
+          hidden = true;
+          return route.fulfill({ json: { success: true } });
+        },
+      );
+
+      await frigateApp.goto("/system#health");
+      const request = frigateApp.page.waitForRequest(
+        (req) =>
+          req.url().includes(`/api/notices/detector_stuck/${action}`) &&
+          req.method() === "POST",
+      );
+      await frigateApp.page
+        .getByTestId("health-problem-notice:detector_stuck")
+        .getByRole("button", {
+          name: action === "mute" ? "Mute" : "Acknowledge",
+          exact: true,
+        })
+        .click();
+      await request;
+
+      await expect(
+        frigateApp.page.locator("[data-testid^='health-problem-']"),
+      ).toHaveCount(0, { timeout: 5_000 });
+      await expect(
+        frigateApp.page.getByText("Your Frigate installation is healthy"),
+      ).toBeVisible();
     });
-
+  }
-    // the list shrinks after the dismiss so the refetch shows the row gone
-    let dismissed = false;
-    await frigateApp.page.route("**/api/notices", (route) =>
-      route.fulfill({ json: dismissed ? [] : [EVENT_NOTICE] }),
-    );
-    await frigateApp.page.route(
-      "**/api/notices/detector_stuck/dismiss",
-      (route) => {
-        dismissed = true;
-        return route.fulfill({ json: { success: true } });
-      },
-    );
-
-    await frigateApp.goto("/system#health");
-    const request = frigateApp.page.waitForRequest(
-      (req) =>
-        req.url().includes("/api/notices/detector_stuck/dismiss") &&
-        req.method() === "POST",
-    );
-    await frigateApp.page
-      .getByTestId("health-problem-notice:detector_stuck")
-      .getByRole("button", { name: "Dismiss" })
-      .click();
-    await request;
-
-    await expect(
-      frigateApp.page.locator("[data-testid^='health-problem-']"),
-    ).toHaveCount(0, { timeout: 5_000 });
-    await expect(
-      frigateApp.page.getByText("Your Frigate installation is healthy"),
-    ).toBeVisible();
-  });
 
   test("empty state with no notices", async ({ frigateApp }) => {
     await frigateApp.installDefaults({ stats: QUIET_STATS });
@@ -140,7 +152,9 @@ test.describe("System — Health tab @medium", () => {
           first_seen: NOW - 3600,
           last_seen: NOW,
           count: 1,
-          dismissed_at: null,
+          acknowledgeable: false,
+          acknowledged_at: null,
+          muted_at: null,
         },
       ],
     });
@@ -156,10 +170,23 @@ test.describe("System — Health tab @medium", () => {
       "href",
       "https://github.com/blakeblackshear/frigate/releases/tag/v0.19.0",
     );
-    await expect(row.getByRole("button", { name: "Dismiss" })).toBeVisible();
+    await expect(
+      row.getByRole("button", { name: "Mute", exact: true }),
+    ).toBeVisible();
+    await expect(row.getByRole("button", { name: "Acknowledge" })).toHaveCount(
+      0,
+    );
   });
 
-  test("the filter shows dismissed notices without a Dismiss button", async ({
+  const ACKNOWLEDGED_NOTICE = {
+    ...EVENT_NOTICE,
+    id: "detector_stuck:coral",
+    params: { detector: "coral" },
+    acknowledged_at: NOW - 60,
+  };
+  const MUTED_NOTICE = { ...ERROR_NOTICE, muted_at: NOW - 120 };
+
+  test("the filter shows hidden notices marked by how they were hidden", async ({
     frigateApp,
   }) => {
     await frigateApp.installDefaults({
@@ -169,33 +196,85 @@ test.describe("System — Health tab @medium", () => {
     await frigateApp.page.route(
       (url) =>
         url.pathname.endsWith("/api/notices") &&
-        url.searchParams.get("include_dismissed") === "true",
+        url.searchParams.get("include_hidden") === "true",
       (route) =>
         route.fulfill({
-          json: [EVENT_NOTICE, { ...ERROR_NOTICE, dismissed_at: NOW - 120 }],
+          json: [EVENT_NOTICE, ACKNOWLEDGED_NOTICE, MUTED_NOTICE],
         }),
     );
     await frigateApp.goto("/system#health");
 
     await frigateApp.page.getByRole("button", { name: "Filter" }).click();
-    const showDismissed = frigateApp.page.getByRole("switch", {
+    const showHidden = frigateApp.page.getByRole("switch", {
-      name: "Show dismissed",
+      name: "Show hidden",
     });
-    await expect(showDismissed).toHaveAttribute("aria-checked", "false");
+    await expect(showHidden).toHaveAttribute("aria-checked", "false");
-    await showDismissed.click();
+    await showHidden.click();
+    // mobile opens the filter as a modal drawer, which hides the rows' roles
+    await frigateApp.page.keyboard.press("Escape");
 
-    const row = frigateApp.page.getByTestId(
+    const acknowledged = frigateApp.page.getByTestId(
+      "health-problem-notice:detector_stuck:coral",
+    );
+    await expect(acknowledged).toBeVisible({ timeout: 15_000 });
+    await expect(acknowledged).toContainText("Acknowledged");
+    await expect(
+      acknowledged.getByRole("button", { name: "Show again" }),
+    ).toBeVisible();
+    await expect(
+      acknowledged.getByRole("button", { name: "Acknowledge" }),
+    ).toHaveCount(0);
+
+    const muted = frigateApp.page.getByTestId(
       "health-problem-notice:model_download_failed:yolo/model.onnx",
     );
-    await expect(row).toBeVisible({ timeout: 15_000 });
+    await expect(muted).toContainText("Muted");
-    await expect(row).toContainText("Dismissed");
+    await expect(muted.getByRole("button", { name: "Unmute" })).toBeVisible();
-    await expect(row.getByRole("button", { name: "Dismiss" })).toHaveCount(0);
+    await expect(
+      muted.getByRole("button", { name: "Mute", exact: true }),
+    ).toHaveCount(0);
 
-    await showDismissed.click();
+    await frigateApp.page.getByRole("button", { name: "Filter" }).click();
-    await expect(row).toHaveCount(0);
+    await showHidden.click();
+    await expect(muted).toHaveCount(0);
   });
 
-  test("clear dismissed deletes the dismissed rows after confirming", async ({
+  test("unmute deletes the row's hidden state", async ({ frigateApp }) => {
+    await frigateApp.installDefaults({ stats: QUIET_STATS, notices: [] });
+    await frigateApp.page.route(
+      (url) =>
+        url.pathname.endsWith("/api/notices") &&
+        url.searchParams.get("include_hidden") === "true",
+      (route) => route.fulfill({ json: [MUTED_NOTICE] }),
+    );
+    await frigateApp.page.route(
+      "**/api/notices/model_download_failed:yolo/model.onnx/hidden",
+      (route) => route.fulfill({ json: { success: true } }),
+    );
+    await frigateApp.goto("/system#health");
+
+    await frigateApp.page.getByRole("button", { name: "Filter" }).click();
+    await frigateApp.page.getByRole("switch", { name: "Show hidden" }).click();
+    await frigateApp.page.keyboard.press("Escape");
+
+    const request = frigateApp.page.waitForRequest(
+      (req) =>
+        req
+          .url()
+          .endsWith(
+            "/api/notices/model_download_failed:yolo/model.onnx/hidden",
+          ) && req.method() === "DELETE",
+    );
+    await frigateApp.page
+      .getByTestId(
+        "health-problem-notice:model_download_failed:yolo/model.onnx",
+      )
+      .getByRole("button", { name: "Unmute" })
+      .click({ timeout: 15_000 });
+    await request;
+  });
+
+  test("show all again unhides every row after confirming", async ({
     frigateApp,
   }) => {
     await frigateApp.installDefaults({
@@ -203,29 +282,25 @@ test.describe("System — Health tab @medium", () => {
       notices: [EVENT_NOTICE],
     });
 
-    // the history loses its dismissed row once the DELETE lands
+    // the hidden list loses its muted row once the DELETE lands
     let cleared = false;
     await frigateApp.page.route(
       (url) =>
         url.pathname.endsWith("/api/notices") &&
-        url.searchParams.get("include_dismissed") === "true",
+        url.searchParams.get("include_hidden") === "true",
       (route) =>
         route.fulfill({
-          json: cleared
+          json: cleared ? [EVENT_NOTICE] : [EVENT_NOTICE, MUTED_NOTICE],
-            ? [EVENT_NOTICE]
-            : [EVENT_NOTICE, { ...ERROR_NOTICE, dismissed_at: NOW - 120 }],
         }),
     );
-    await frigateApp.page.route("**/api/notices/dismissed", (route) => {
+    await frigateApp.page.route("**/api/notices/hidden", (route) => {
       cleared = true;
       return route.fulfill({ json: { success: true } });
     });
     await frigateApp.goto("/system#health");
 
     await frigateApp.page.getByRole("button", { name: "Filter" }).click();
-    await frigateApp.page
+    await frigateApp.page.getByRole("switch", { name: "Show hidden" }).click();
-      .getByRole("switch", { name: "Show dismissed" })
-      .click();
     const row = frigateApp.page.getByTestId(
       "health-problem-notice:model_download_failed:yolo/model.onnx",
     );
@@ -233,23 +308,20 @@ test.describe("System — Health tab @medium", () => {
     await frigateApp.page.keyboard.press("Escape");
 
     await frigateApp.page
-      .getByRole("button", { name: "Clear dismissed" })
+      .getByRole("button", { name: "Show all again" })
       .click();
     const request = frigateApp.page.waitForRequest(
       (req) =>
-        req.url().endsWith("/api/notices/dismissed") &&
+        req.url().endsWith("/api/notices/hidden") && req.method() === "DELETE",
-        req.method() === "DELETE",
     );
     await frigateApp.page
       .getByRole("alertdialog")
-      .getByRole("button", { name: "Clear dismissed" })
+      .getByRole("button", { name: "Show all again" })
       .click();
     await request;
 
     await expect(row).toHaveCount(0);
-    await expect(
+    await expect(frigateApp.page.getByText("No hidden notices")).toBeVisible();
-      frigateApp.page.getByText("No dismissed notices"),
-    ).toBeVisible();
   });
 
   test("severity switches hide notices of that severity", async ({
@@ -290,7 +362,9 @@ test.describe("System — Health tab @medium", () => {
       first_seen: start,
       last_seen: start + 60,
       count,
-      dismissed_at: null,
+      acknowledgeable: true,
+      acknowledged_at: null,
+      muted_at: null,
     });
     await frigateApp.installDefaults({
       stats: QUIET_STATS,
@@ -332,7 +406,9 @@ test.describe("System — Health tab @medium", () => {
           first_seen: NOW - 600,
           last_seen: NOW - 600,
           count: 1,
-          dismissed_at: null,
+          acknowledgeable: true,
+          acknowledged_at: null,
+          muted_at: null,
         },
       ],
     });
@@ -363,7 +439,9 @@ test.describe("System — Health tab @medium", () => {
           first_seen: NOW - 600,
           last_seen: NOW - 600,
           count: 1,
-          dismissed_at: null,
+          acknowledgeable: true,
+          acknowledged_at: null,
+          muted_at: null,
         },
       ],
     });
@@ -695,7 +773,7 @@ test.describe("System — Health notices sources @medium", () => {
 
     // the status bar shows a problem, so stats have loaded
     await expect(
-      frigateApp.page.getByText("Front Door is offline"),
+      frigateApp.page.getByText("Recordings are being deleted"),
     ).toBeVisible({ timeout: 15_000 });
     await expect(
       frigateApp.page.locator("[data-testid^='health-problem-']"),
@@ -1046,7 +1124,7 @@ test.describe("System — Health notices sources @medium", () => {
     await expect(frigateApp.page).toHaveURL(/\/system#health/);
   });
 
-  test("status bar counts undismissed notices next to the health text", async ({
+  test("status bar counts shown notices next to the health text", async ({
     frigateApp,
   }) => {
     test.skip(frigateApp.isMobile, "Status bar is desktop-only");
@@ -1089,41 +1167,61 @@ test.describe("System — Health notices sources @medium", () => {
     await expect(frigateApp.page.getByText("System is healthy")).toHaveCount(0);
   });
 
-  test("a config row can be dismissed", async ({ frigateApp }) => {
+  // the slow detector warning is added before the offline error
-    const id = "config:detect:fps-greater-than-five:camera.garage";
+  const TWO_PROBLEM_STATS = {
-    await frigateApp.installDefaults({
+    detectors: { cpu: { inference_speed: 60 } },
-      config: {
+    cameras: { front_door: { camera_fps: 0 } },
-        cameras: {
+  };
-          garage: { detect: { width: 2560, height: 1440, fps: 10 } },
-        },
-      },
-      stats: QUIET_STATS,
-    });
 
-    // the list gains the dismissal after the POST so the refetch hides the row
+  test("status bar collapses several problems behind the most severe", async ({
-    let dismissed = false;
+    frigateApp,
-    await frigateApp.page.route(`**/api/notices/${id}/dismiss`, (route) => {
+  }) => {
-      dismissed = true;
+    test.skip(frigateApp.isMobile, "Status bar is desktop-only");
-      return route.fulfill({ json: { success: true } });
+    await frigateApp.installDefaults({ stats: TWO_PROBLEM_STATS });
-    });
+    await frigateApp.goto("/");
-    await frigateApp.page.route("**/api/notices/dismissed_checks", (route) =>
-      route.fulfill({ json: dismissed ? [{ id, dismissed_at: NOW }] : [] }),
-    );
-    await frigateApp.goto("/system#health");
 
-    const row = frigateApp.page.getByTestId(`health-problem-${id}`);
+    const summary = frigateApp.page.getByRole("button", {
-    await expect(row).toBeVisible({ timeout: 15_000 });
+      name: "Front Door is offline +1",
-    const request = frigateApp.page.waitForRequest(
+    });
-      (req) =>
+    await expect(summary).toBeVisible({ timeout: 15_000 });
-        req.url().includes(`/api/notices/${id}/dismiss`) &&
+    await expect(frigateApp.page.getByText("Cpu is slow")).toHaveCount(0);
-        req.method() === "POST",
+
-    );
+    await summary.click();
-    await row.getByRole("button", { name: "Dismiss" }).click();
+    const list = frigateApp.page.getByTestId("status-message-list");
-    await request;
+    await expect(list.getByRole("link")).toHaveText([
-    await expect(row).toHaveCount(0);
+      "Front Door is offline",
+      "Cpu is slow (60 ms)",
+    ]);
+
+    await list.getByRole("link", { name: "Cpu is slow (60 ms)" }).click();
+    await expect(frigateApp.page).toHaveURL(/\/system#general/);
+    await expect(list).toHaveCount(0);
   });
 
-  test("dismissed config rows move to the dismissed list", async ({
+  test("mobile status drawer stacks every problem", async ({ frigateApp }) => {
+    test.skip(!frigateApp.isMobile, "Mobile-only");
+    await frigateApp.installDefaults({ stats: TWO_PROBLEM_STATS });
+    await frigateApp.goto("/");
+
+    await frigateApp.page
+      .getByTestId("status-alert-trigger")
+      .click({ timeout: 15_000 });
+    const items = frigateApp.page
+      .getByTestId("status-message-list")
+      .getByRole("link");
+    await expect(items).toHaveText([
+      "Front Door is offline",
+      "Cpu is slow (60 ms)",
+    ]);
+
+    const [first, second] = await Promise.all([
+      items.nth(0).boundingBox(),
+      items.nth(1).boundingBox(),
+    ]);
+    expect(second!.y).toBeGreaterThan(first!.y);
+  });
+
+  test("a config row can be muted but not acknowledged", async ({
     frigateApp,
   }) => {
     const id = "config:detect:fps-greater-than-five:camera.garage";
@@ -1134,12 +1232,49 @@ test.describe("System — Health notices sources @medium", () => {
         },
       },
       stats: QUIET_STATS,
-      dismissedChecks: [{ id, dismissed_at: NOW - 120 }],
+    });
+
+    // the list gains the mute after the POST so the refetch hides the row
+    let muted = false;
+    await frigateApp.page.route(`**/api/notices/${id}/mute`, (route) => {
+      muted = true;
+      return route.fulfill({ json: { success: true } });
+    });
+    await frigateApp.page.route("**/api/notices/muted_checks", (route) =>
+      route.fulfill({ json: muted ? [{ id, muted_at: NOW }] : [] }),
+    );
+    await frigateApp.goto("/system#health");
+
+    const row = frigateApp.page.getByTestId(`health-problem-${id}`);
+    await expect(row).toBeVisible({ timeout: 15_000 });
+    await expect(row.getByRole("button", { name: "Acknowledge" })).toHaveCount(
+      0,
+    );
+    const request = frigateApp.page.waitForRequest(
+      (req) =>
+        req.url().includes(`/api/notices/${id}/mute`) &&
+        req.method() === "POST",
+    );
+    await row.getByRole("button", { name: "Mute", exact: true }).click();
+    await request;
+    await expect(row).toHaveCount(0);
+  });
+
+  test("muted config rows move to the hidden list", async ({ frigateApp }) => {
+    const id = "config:detect:fps-greater-than-five:camera.garage";
+    await frigateApp.installDefaults({
+      config: {
+        cameras: {
+          garage: { detect: { width: 2560, height: 1440, fps: 10 } },
+        },
+      },
+      stats: QUIET_STATS,
+      mutedChecks: [{ id, muted_at: NOW - 120 }],
     });
     await frigateApp.page.route(
       (url) =>
         url.pathname.endsWith("/api/notices") &&
-        url.searchParams.get("include_dismissed") === "true",
+        url.searchParams.get("include_hidden") === "true",
       (route) => route.fulfill({ json: [] }),
     );
     await frigateApp.goto("/system#health");
@@ -1153,12 +1288,14 @@ test.describe("System — Health notices sources @medium", () => {
     await expect(row).toHaveCount(0);
 
     await frigateApp.page.getByRole("button", { name: "Filter" }).click();
-    await frigateApp.page
+    await frigateApp.page.getByRole("switch", { name: "Show hidden" }).click();
-      .getByRole("switch", { name: "Show dismissed" })
+    await frigateApp.page.keyboard.press("Escape");
-      .click();
 
     await expect(row).toBeVisible();
-    await expect(row).toContainText("Dismissed");
+    await expect(row).toContainText("Muted");
-    await expect(row.getByRole("button", { name: "Dismiss" })).toHaveCount(0);
+    await expect(row.getByRole("button", { name: "Unmute" })).toBeVisible();
+    await expect(
+      row.getByRole("button", { name: "Mute", exact: true }),
+    ).toHaveCount(0);
   });
 });

web/public/locales/en/components/player.json

@@ -45,7 +45,9 @@
       }
     },
     "decodedFrames": "Decoded Frames:",
-    "droppedFrameRate": "Dropped Frame Rate:"
+    "droppedFrameRate": "Dropped Frame Rate:",
+    "stream": "Stream:",
+    "streamAuto": "{{stream}} (auto)"
   },
   "toast": {
     "success": {