Translated using Weblate (Chinese (Simplified Han script))

Currently translated at 100.0% (114 of 114 strings) Translated using Weblate (Chinese (Simplified Han script)) Currently translated at 100.0% (352 of 352 strings) Translated using Weblate (Chinese (Simplified Han script)) Currently translated at 100.0% (48 of 48 strings) Translated using Weblate (Chinese (Simplified Han script)) Currently translated at 100.0% (80 of 80 strings) Translated using Weblate (Chinese (Simplified Han script)) Currently translated at 100.0% (115 of 115 strings) Translated using Weblate (Chinese (Simplified Han script)) Currently translated at 100.0% (352 of 352 strings) Co-authored-by: GuoQing Liu <842607283@qq.com> Co-authored-by: Hosted Weblate <hosted@weblate.org> Translate-URL: https://hosted.weblate.org/projects/frigate-nvr/views-explore/zh_Hans/ Translate-URL: https://hosted.weblate.org/projects/frigate-nvr/views-live/zh_Hans/ Translate-URL: https://hosted.weblate.org/projects/frigate-nvr/views-search/zh_Hans/ Translate-URL: https://hosted.weblate.org/projects/frigate-nvr/views-settings/zh_Hans/ Translate-URL: https://hosted.weblate.org/projects/frigate-nvr/views-system/zh_Hans/ Translation: Frigate NVR/views-explore Translation: Frigate NVR/views-live Translation: Frigate NVR/views-search Translation: Frigate NVR/views-settings Translation: Frigate NVR/views-system
Translated using Weblate (Slovak)
2026-07-21 19:29:00 +03:00 · 2025-07-11 20:42:03 -05:00 · 2025-07-11 20:42:03 -05:00 · 2025-07-11 20:42:03 -05:00 · 2025-07-11 20:42:03 -05:00 · 2025-07-11 20:42:03 -05:00
452 changed files with 16033 additions and 2104 deletions
@@ -41,6 +41,7 @@ jobs:
          target: frigate
          tags: ${{ steps.setup.outputs.image-name }}-amd64
          cache-from: type=registry,ref=${{ steps.setup.outputs.cache-name }}-amd64
+          cache-to: type=registry,ref=${{ steps.setup.outputs.cache-name }}-amd64,mode=max
  arm64_build:
    runs-on: ubuntu-22.04-arm
    name: ARM Build
@@ -161,8 +162,8 @@ jobs:
          files: docker/tensorrt/trt.hcl
          set: |
            tensorrt.tags=${{ steps.setup.outputs.image-name }}-tensorrt
-            *.cache-from=type=registry,ref=${{ steps.setup.outputs.cache-name }}-amd64
-            *.cache-to=type=registry,ref=${{ steps.setup.outputs.cache-name }}-amd64,mode=max
+            *.cache-from=type=registry,ref=${{ steps.setup.outputs.cache-name }}-tensorrt
+            *.cache-to=type=registry,ref=${{ steps.setup.outputs.cache-name }}-tensorrt,mode=max
      - name: AMD/ROCm general build
        env:
          AMDGPU: gfx
@@ -176,7 +177,7 @@ jobs:
          set: |
            rocm.tags=${{ steps.setup.outputs.image-name }}-rocm
            *.cache-to=type=registry,ref=${{ steps.setup.outputs.cache-name }}-rocm,mode=max
-            *.cache-from=type=gha
+            *.cache-from=type=registry,ref=${{ steps.setup.outputs.cache-name }}-rocm
  arm64_extra_builds:
    runs-on: ubuntu-22.04-arm
    name: ARM Extra Build
@@ -39,7 +39,7 @@
 <img width="800" alt="实时监控面板" src="https://github.com/blakeblackshear/frigate/assets/569905/5e713cb9-9db5-41dc-947a-6937c3bc376e">
 </div>

-### 简单的审查工作流程
+### 简单的核查工作流程
 <div>
 <img width="800" alt="简单的审查工作流程" src="https://github.com/blakeblackshear/frigate/assets/569905/6fed96e8-3b18-40e5-9ddc-31e6f3c9f2ff">
 </div>
@@ -60,6 +60,11 @@


 ## 非官方中文讨论社区
-欢迎加入中文讨论QQ群：1043861059
+欢迎加入中文讨论QQ群：[1043861059](https://qm.qq.com/q/7vQKsTmSz)

 Bilibili：https://space.bilibili.com/3546894915602564
+
+
+## 中文社区赞助商
+[![EdgeOne](https://edgeone.ai/media/34fe3a45-492d-4ea4-ae5d-ea1087ca7b4b.png)](https://edgeone.ai/zh?from=github)
+本项目 CDN 加速及安全防护由 Tencent EdgeOne 赞助
@@ -4,7 +4,7 @@
 sudo apt-get update
 sudo apt-get install -y build-essential cmake git wget

-hailo_version="4.20.1"
+hailo_version="4.21.0"
 arch=$(uname -m)

 if [[ $arch == "x86_64" ]]; then
@@ -2,7 +2,7 @@

 set -euxo pipefail

-hailo_version="4.20.1"
+hailo_version="4.21.0"

 if [[ "${TARGETARCH}" == "amd64" ]]; then
    arch="x86_64"
@@ -6,7 +6,7 @@ set -o errexit -o nounset -o pipefail

 # opt out of openvino telemetry
 if [ -e /usr/local/bin/opt_in_out ]; then
-  /usr/local/bin/opt_in_out --opt_out
+  /usr/local/bin/opt_in_out --opt_out > /dev/null 2>&1
 fi

 # Logs should be sent to stdout so that s6 can collect them
@@ -28,7 +28,7 @@ COPY docker/rockchip/conv2rknn.py /opt/conv2rknn.py

 ADD https://github.com/MarcA711/rknn-toolkit2/releases/download/v2.3.2/librknnrt.so /usr/lib/

-ADD --chmod=111 https://github.com/MarcA711/Rockchip-FFmpeg-Builds/releases/download/6.1-7/ffmpeg /usr/lib/ffmpeg/6.0/bin/
-ADD --chmod=111 https://github.com/MarcA711/Rockchip-FFmpeg-Builds/releases/download/6.1-7/ffprobe /usr/lib/ffmpeg/6.0/bin/
+ADD --chmod=111 https://github.com/MarcA711/Rockchip-FFmpeg-Builds/releases/download/6.1-11/ffmpeg /usr/lib/ffmpeg/6.0/bin/
+ADD --chmod=111 https://github.com/MarcA711/Rockchip-FFmpeg-Builds/releases/download/6.1-11/ffprobe /usr/lib/ffmpeg/6.0/bin/
 ENV DEFAULT_FFMPEG_VERSION="6.0"
 ENV INCLUDED_FFMPEG_VERSIONS="${DEFAULT_FFMPEG_VERSION}:${INCLUDED_FFMPEG_VERSIONS}"
@@ -63,6 +63,7 @@ COPY --from=rocm /opt/rocm-dist/ /
 FROM deps-prelim AS rocm-prelim-hsa-override0
 ENV HSA_ENABLE_SDMA=0
 ENV MIGRAPHX_ENABLE_NHWC=1
+ENV TF_ROCM_USE_IMMEDIATE_MODE=1

 COPY --from=rocm-dist / /

@@ -6,24 +6,29 @@ ARG DEBIAN_FRONTEND=noninteractive
 # Globally set pip break-system-packages option to avoid having to specify it every time
 ARG PIP_BREAK_SYSTEM_PACKAGES=1

-FROM tensorrt-base AS frigate-tensorrt
+FROM wheels AS trt-wheels
 ARG PIP_BREAK_SYSTEM_PACKAGES
-ENV TRT_VER=8.6.1

 # Install TensorRT wheels
 COPY docker/tensorrt/requirements-amd64.txt /requirements-tensorrt.txt
-RUN pip3 install -U -r /requirements-tensorrt.txt && ldconfig
+COPY docker/main/requirements-wheels.txt /requirements-wheels.txt
+RUN  pip3 wheel --wheel-dir=/trt-wheels -c /requirements-wheels.txt -r /requirements-tensorrt.txt
+
+FROM deps AS frigate-tensorrt
+ARG PIP_BREAK_SYSTEM_PACKAGES
+
+RUN --mount=type=bind,from=trt-wheels,source=/trt-wheels,target=/deps/trt-wheels \
+    pip3 uninstall -y onnxruntime-openvino tensorflow-cpu \
+    && pip3 install -U /deps/trt-wheels/*.whl
+
+COPY --from=rootfs / /
+COPY docker/tensorrt/detector/rootfs/etc/ld.so.conf.d /etc/ld.so.conf.d
+RUN ldconfig

 WORKDIR /opt/frigate/
-COPY --from=rootfs / /

 # Dev Container w/ TRT
 FROM devcontainer AS devcontainer-trt

-COPY --from=trt-deps /usr/local/lib/libyolo_layer.so /usr/local/lib/libyolo_layer.so
-COPY --from=trt-deps /usr/local/src/tensorrt_demos /usr/local/src/tensorrt_demos
-COPY --from=trt-deps /usr/local/cuda-12.1 /usr/local/cuda
-COPY docker/tensorrt/detector/rootfs/ /
-COPY --from=trt-deps /usr/local/lib/libyolo_layer.so /usr/local/lib/libyolo_layer.so
 RUN --mount=type=bind,from=trt-wheels,source=/trt-wheels,target=/deps/trt-wheels \
    pip3 install -U /deps/trt-wheels/*.whl
@@ -1,9 +1,61 @@
-# syntax=docker/dockerfile:1.4
+# syntax=docker/dockerfile:1.6

 # https://askubuntu.com/questions/972516/debian-frontend-environment-variable
 ARG DEBIAN_FRONTEND=noninteractive
-
 ARG BASE_IMAGE
+ARG TRT_BASE=nvcr.io/nvidia/tensorrt:23.12-py3
+
+# Build TensorRT-specific library
+FROM ${TRT_BASE} AS trt-deps
+
+ARG TARGETARCH
+ARG COMPUTE_LEVEL
+
+RUN apt-get update \
+    && apt-get install -y git build-essential cuda-nvcc-* cuda-nvtx-* libnvinfer-dev libnvinfer-plugin-dev libnvparsers-dev libnvonnxparsers-dev \
+    && rm -rf /var/lib/apt/lists/*
+RUN --mount=type=bind,source=docker/tensorrt/detector/tensorrt_libyolo.sh,target=/tensorrt_libyolo.sh \
+    /tensorrt_libyolo.sh
+
+# COPY required individual CUDA deps
+RUN mkdir -p /usr/local/cuda-deps
+RUN if [ "$TARGETARCH" = "amd64" ]; then \
+    cp /usr/local/cuda-12.3/targets/x86_64-linux/lib/libcurand.so.* /usr/local/cuda-deps/ && \
+    cp /usr/local/cuda-12.3/targets/x86_64-linux/lib/libnvrtc.so.* /usr/local/cuda-deps/ && \
+    cd /usr/local/cuda-deps/ && \
+    for lib in libnvrtc.so.*; do \
+    if [[ "$lib" =~ libnvrtc.so\.([0-9]+\.[0-9]+\.[0-9]+) ]]; then \
+    version="${BASH_REMATCH[1]}"; \
+    ln -sf "libnvrtc.so.$version" libnvrtc.so; \
+    fi; \
+    done && \
+    for lib in libcurand.so.*; do \
+    if [[ "$lib" =~ libcurand.so\.([0-9]+\.[0-9]+\.[0-9]+\.[0-9]+) ]]; then \
+    version="${BASH_REMATCH[1]}"; \
+    ln -sf "libcurand.so.$version" libcurand.so; \
+    fi; \
+    done; \
+    fi
+
+# Frigate w/ TensorRT Support as separate image
+FROM deps AS tensorrt-base
+
+#Disable S6 Global timeout
+ENV S6_CMD_WAIT_FOR_SERVICES_MAXTIME=0
+
+# COPY TensorRT Model Generation Deps
+COPY --from=trt-deps /usr/local/lib/libyolo_layer.so /usr/local/lib/libyolo_layer.so
+COPY --from=trt-deps /usr/local/src/tensorrt_demos /usr/local/src/tensorrt_demos
+
+# COPY Individual CUDA deps folder
+COPY --from=trt-deps /usr/local/cuda-deps /usr/local/cuda
+
+COPY docker/tensorrt/detector/rootfs/ /
+ENV YOLO_MODELS=""
+
+HEALTHCHECK --start-period=600s --start-interval=5s --interval=15s --timeout=5s --retries=3 \
+    CMD curl --fail --silent --show-error http://127.0.0.1:5000/api/version || exit 1
+
 FROM ${BASE_IMAGE} AS build-wheels
 ARG DEBIAN_FRONTEND

@@ -100,4 +152,4 @@ WORKDIR /opt/frigate/
 COPY --from=rootfs / /

 # 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
+ENV LD_PRELOAD /usr/lib/aarch64-linux-gnu/libstdc++.so.6
@@ -1,57 +0,0 @@
-# syntax=docker/dockerfile:1.6
-
-# https://askubuntu.com/questions/972516/debian-frontend-environment-variable
-ARG DEBIAN_FRONTEND=noninteractive
-
-ARG TRT_BASE=nvcr.io/nvidia/tensorrt:23.12-py3
-
-# Build TensorRT-specific library
-FROM ${TRT_BASE} AS trt-deps
-
-ARG TARGETARCH
-ARG COMPUTE_LEVEL
-
-RUN apt-get update \
-    && apt-get install -y git build-essential cuda-nvcc-* cuda-nvtx-* libnvinfer-dev libnvinfer-plugin-dev libnvparsers-dev libnvonnxparsers-dev \
-    && rm -rf /var/lib/apt/lists/*
-RUN --mount=type=bind,source=docker/tensorrt/detector/tensorrt_libyolo.sh,target=/tensorrt_libyolo.sh \
-    /tensorrt_libyolo.sh
-
-# COPY required individual CUDA deps
-RUN mkdir -p /usr/local/cuda-deps
-RUN if [ "$TARGETARCH" = "amd64" ]; then \
-      cp /usr/local/cuda-12.3/targets/x86_64-linux/lib/libcurand.so.* /usr/local/cuda-deps/ && \
-      cp /usr/local/cuda-12.3/targets/x86_64-linux/lib/libnvrtc.so.* /usr/local/cuda-deps/ && \
-      cd /usr/local/cuda-deps/ && \
-      for lib in libnvrtc.so.*; do \
-        if [[ "$lib" =~ libnvrtc.so\.([0-9]+\.[0-9]+\.[0-9]+) ]]; then \
-          version="${BASH_REMATCH[1]}"; \
-          ln -sf "libnvrtc.so.$version" libnvrtc.so; \
-        fi; \
-      done && \
-      for lib in libcurand.so.*; do \
-        if [[ "$lib" =~ libcurand.so\.([0-9]+\.[0-9]+\.[0-9]+\.[0-9]+) ]]; then \
-          version="${BASH_REMATCH[1]}"; \
-          ln -sf "libcurand.so.$version" libcurand.so; \
-        fi; \
-      done; \
-    fi
-
-# Frigate w/ TensorRT Support as separate image
-FROM deps AS tensorrt-base
-
-#Disable S6 Global timeout
-ENV S6_CMD_WAIT_FOR_SERVICES_MAXTIME=0
-
-# COPY TensorRT Model Generation Deps
-COPY --from=trt-deps /usr/local/lib/libyolo_layer.so /usr/local/lib/libyolo_layer.so
-COPY --from=trt-deps /usr/local/src/tensorrt_demos /usr/local/src/tensorrt_demos
-
-# COPY Individual CUDA deps folder
-COPY --from=trt-deps /usr/local/cuda-deps /usr/local/cuda
-
-COPY docker/tensorrt/detector/rootfs/ /
-ENV YOLO_MODELS=""
-
-HEALTHCHECK --start-period=600s --start-interval=5s --interval=15s --timeout=5s --retries=3 \
-    CMD curl --fail --silent --show-error http://127.0.0.1:5000/api/version || exit 1
@@ -1,7 +1,6 @@
-/usr/local/lib
-/usr/local/cuda
-/usr/local/lib/python3.11/dist-packages/tensorrt
 /usr/local/lib/python3.11/dist-packages/nvidia/cudnn/lib
 /usr/local/lib/python3.11/dist-packages/nvidia/cuda_runtime/lib
 /usr/local/lib/python3.11/dist-packages/nvidia/cublas/lib
-/usr/local/lib/python3.11/dist-packages/nvidia/cufft/lib
+/usr/local/lib/python3.11/dist-packages/nvidia/cufft/lib
+/usr/local/lib/python3.11/dist-packages/nvidia/curand/lib/
+/usr/local/lib/python3.11/dist-packages/nvidia/cuda_nvrtc/lib/
@@ -1,17 +1,18 @@
 # NVidia TensorRT Support (amd64 only)
 --extra-index-url 'https://pypi.nvidia.com'
-numpy < 1.24; platform_machine == 'x86_64'
-tensorrt == 8.6.1; platform_machine == 'x86_64'
-tensorrt_bindings == 8.6.1; platform_machine == 'x86_64'
-cuda-python == 11.8.*; platform_machine == 'x86_64'
-cython == 3.0.*; platform_machine == 'x86_64'
-nvidia-cuda-runtime-cu12 == 12.1.*; platform_machine == 'x86_64'
-nvidia-cuda-runtime-cu11 == 11.8.*; platform_machine == 'x86_64'
-nvidia-cublas-cu11 == 11.11.3.6; platform_machine == 'x86_64'
-nvidia-cudnn-cu11 == 8.6.0.*; platform_machine == 'x86_64'
-nvidia-cudnn-cu12 == 9.5.0.*; platform_machine == 'x86_64'
-nvidia-cufft-cu11==10.*; platform_machine == 'x86_64'
-nvidia-cufft-cu12==11.*; platform_machine == 'x86_64'
+cython==3.0.*; platform_machine == 'x86_64'
+nvidia_cuda_cupti_cu12==12.5.82; platform_machine == 'x86_64'
+nvidia-cublas-cu12==12.5.3.*; platform_machine == 'x86_64'
+nvidia-cudnn-cu12==9.3.0.*; platform_machine == 'x86_64'
+nvidia-cufft-cu12==11.2.3.*; platform_machine == 'x86_64'
+nvidia-curand-cu12==10.3.6.*; platform_machine == 'x86_64'
+nvidia_cuda_nvcc_cu12==12.5.82; platform_machine == 'x86_64'
+nvidia-cuda-nvrtc-cu12==12.5.82; platform_machine == 'x86_64'
+nvidia_cuda_runtime_cu12==12.5.82; platform_machine == 'x86_64'
+nvidia_cusolver_cu12==11.6.3.*; platform_machine == 'x86_64'
+nvidia_cusparse_cu12==12.5.1.*; platform_machine == 'x86_64'
+nvidia_nccl_cu12==2.23.4; platform_machine == 'x86_64'
+nvidia_nvjitlink_cu12==12.5.82; platform_machine == 'x86_64'
 onnx==1.16.*; platform_machine == 'x86_64'
-onnxruntime-gpu==1.20.*; platform_machine == 'x86_64'
+onnxruntime-gpu==1.22.*; platform_machine == 'x86_64'
 protobuf==3.20.3; platform_machine == 'x86_64'
@@ -79,21 +79,13 @@ target "trt-deps" {
  inherits = ["_build_args"]
 }

-target "tensorrt-base" {
-  dockerfile = "docker/tensorrt/Dockerfile.base"
-  context = "."
-  contexts = {
-    deps = "target:deps",
-  }
-  inherits = ["_build_args"]
-}
-
 target "tensorrt" {
  dockerfile = "docker/tensorrt/Dockerfile.${ARCH}"
  context = "."
  contexts = {
    wget = "target:wget",
-    tensorrt-base = "target:tensorrt-base",
+    wheels = "target:wheels",
+    deps = "target:deps",
    rootfs = "target:rootfs"
  }
  target = "frigate-tensorrt"
@@ -52,6 +52,21 @@ auth:
    - 172.18.0.0/16 # <---- this is the subnet for the internal Docker Compose network
 ```

+## Session Length
+
+The default session length for user authentication in Frigate is 24 hours. This setting determines how long a user's authenticated session remains active before a token refresh is required — otherwise, the user will need to log in again.
+
+While the default provides a balance of security and convenience, you can customize this duration to suit your specific security requirements and user experience preferences. The session length is configured in seconds.
+
+The default value of `86400` will expire the authentication session after 24 hours. Some other examples:
+- `0`: Setting the session length to 0 will require a user to log in every time they access the application or after a very short, immediate timeout.
+- `604800`: Setting the session length to 604800 will require a user to log in if the token is not refreshed for 7 days.
+
+```yaml
+auth:
+  session_length: 86400
+```
+
 ## JWT Token Secret

 The JWT token secret needs to be kept secure. Anyone with this secret can generate valid JWT tokens to authenticate with Frigate. This should be a cryptographically random string of at least 64 characters.
@@ -243,3 +243,38 @@ ffmpeg:
 ### TP-Link VIGI Cameras

 TP-Link VIGI cameras need some adjustments to the main stream settings on the camera itself to avoid issues. The stream needs to be configured as `H264` with `Smart Coding` set to `off`. Without these settings you may have problems when trying to watch recorded footage. For example Firefox will stop playback after a few seconds and show the following error message: `The media playback was aborted due to a corruption problem or because the media used features your browser did not support.`.
+
+## USB Cameras (aka Webcams)
+
+To use a USB camera (webcam) with Frigate, the recommendation is to use go2rtc's [FFmpeg Device](https://github.com/AlexxIT/go2rtc?tab=readme-ov-file#source-ffmpeg-device) support:
+
+- Preparation outside of Frigate:
+  - Get USB camera path. Run `v4l2-ctl --list-devices` to get a listing of locally-connected cameras available. (You may need to install `v4l-utils` in a way appropriate for your Linux distribution). In the sample configuration below, we use `video=0` to correlate with a detected device path of `/dev/video0`
+  - Get USB camera formats & resolutions. Run `ffmpeg -f v4l2 -list_formats all -i /dev/video0` to get an idea of what formats and resolutions the USB Camera supports. In the sample configuration below, we use a width of 1024 and height of 576 in the stream and detection settings based on what was reported back.
+  - If using Frigate in a container (e.g. Docker on TrueNAS), ensure you have USB Passthrough support enabled, along with a specific Host Device (`/dev/video0`) + Container Device (`/dev/video0`) listed.
+
+- In your Frigate Configuration File, add the go2rtc stream and roles as appropriate:
+
+```
+go2rtc:
+  streams:
+    usb_camera:
+      - "ffmpeg:device?video=0&video_size=1024x576#video=h264" 
+
+cameras:
+  usb_camera:
+    enabled: true
+    ffmpeg:
+      inputs:
+        - path: rtsp://127.0.0.1:8554/usb_camera
+          input_args: preset-rtsp-restream
+          roles:
+            - detect
+            - record
+    detect:
+      enabled: false # <---- disable detection until you have a working camera feed
+      width: 1024
+      height: 576
+```
+
+
@@ -97,9 +97,12 @@ This list of working and non-working PTZ cameras is based on user feedback.
 | Amcrest ASH21                |      ✅      |      ❌      | ONVIF service port: 80                                                                                                                          |
 | Amcrest IP4M-S2112EW-AI      |      ✅      |      ❌      | FOV relative movement not supported.                                                                                                            |
 | Amcrest IP5M-1190EW          |      ✅      |      ❌      | ONVIF Port: 80. FOV relative movement not supported.                                                                                            |
+| Annke CZ504                  |      ✅      |      ✅      | Annke support provide specific firmware ([V5.7.1 build 250227](https://github.com/pierrepinon/annke_cz504/raw/refs/heads/main/digicap_V5-7-1_build_250227.dav)) to fix issue with ONVIF "TranslationSpaceFov" |
 | Ctronics PTZ                 |      ✅      |      ❌      |                                                                                                                                                 |
-| Dahua                        |      ✅      |      ✅      |                                                                                                                                                 |
+| Dahua                        |      ✅      |      ✅      | Some low-end Dahuas (lite series, among others) have been reported to not support autotracking                                                  |
 | Dahua DH-SD2A500HB           |      ✅      |      ❌      |                                                                                                                                                 |
+| Dahua DH-SD49825GB-HNR       |      ✅      |      ✅      |                                                                                                                                                 |
+| Dahua DH-P5AE-PV             |      ❌      |      ❌      |                                                                                                                                                 |
 | Foscam R5                    |      ✅      |      ❌      |                                                                                                                                                 |
 | Hanwha XNP-6550RH            |      ✅      |      ❌      |                                                                                                                                                 |
 | Hikvision                    |      ✅      |      ❌      | Incomplete ONVIF support (MoveStatus won't update even on latest firmware) - reported with HWP-N4215IH-DE and DS-2DE3304W-DE, but likely others |
@@ -45,6 +45,8 @@ face_recognition:
  enabled: true
 ```

+Like the other real-time processors in Frigate, face recognition runs on the camera stream defined by the `detect` role in your config. To ensure optimal performance, select a suitable resolution for this stream in your camera's firmware that fits your specific scene and requirements.
+
 ## Advanced Configuration

 Fine-tune face recognition with these optional parameters at the global level of your config. The only optional parameters that can be set at the camera level are `enabled` and `min_area`.
@@ -65,7 +67,7 @@ Fine-tune face recognition with these optional parameters at the global level of
  - Default: `0.8`.
 - `recognition_threshold`: Recognition confidence score required to add the face to the object as a sub label.
  - Default: `0.9`.
- `min_faces`: Min face attempts for the sub label to be applied to the person object.
+- `min_faces`: Min face recognitions for the sub label to be applied to the person object.
  - Default: `1`
 - `save_attempts`: Number of images of recognized faces to save for training.
  - Default: `100`.
@@ -131,6 +133,27 @@ Once front-facing images are performing well, start choosing slightly off-angle

 ## FAQ

+### How do I debug Face Recognition issues?
+
+Start with the [Usage](#usage) section and re-read the [Model Requirements](#model-requirements) above.
+
+1. Ensure `person` is being _detected_. A `person` will automatically be scanned by Frigate for a face. Any detected faces will appear in the Train tab in the Frigate UI's Face Library.
+
+   If you are using a Frigate+ or `face` detecting model:
+
+   - Watch the debug view (Settings --> Debug) to ensure that `face` is being detected along with `person`.
+   - You may need to adjust the `min_score` for the `face` object if faces are not being detected.
+
+   If you are **not** using a Frigate+ or `face` detecting model:
+
+   - Check your `detect` stream resolution and ensure it is sufficiently high enough to capture face details on `person` objects.
+   - You may need to lower your `detection_threshold` if faces are not being detected.
+
+2. Any detected faces will then be _recognized_.
+
+   - Make sure you have trained at least one face per the recommendations above.
+   - Adjust `recognition_threshold` settings per the suggestions [above](#advanced-configuration).
+
 ### Detection does not work well with blurry images?

 Accuracy is definitely a going to be improved with higher quality cameras / streams. It is important to look at the DORI (Detection Observation Recognition Identification) range of your camera, if that specification is posted. This specification explains the distance from the camera that a person can be detected, observed, recognized, and identified. The identification range is the most relevant here, and the distance listed by the camera is the furthest that face recognition will realistically work.
@@ -71,11 +71,11 @@ cameras:

 Output args presets help make the config more readable and handle use cases for different types of streams to ensure consistent recordings.

-| Preset                           | Usage                             | Other Notes                                                                                                                          |
-| -------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
-| preset-record-generic            | Record WITHOUT audio              | This is the default when nothing is specified                                                                                        |
-| preset-record-generic-audio-copy | Record WITH original audio        | Use this to enable audio in recordings                                                                                               |
-| preset-record-generic-audio-aac  | Record WITH transcoded aac audio  | Use this to transcode to aac audio. If your source is already aac, use preset-record-generic-audio-copy instead to avoid re-encoding |
-| preset-record-mjpeg              | Record an mjpeg stream            | Recommend restreaming mjpeg stream instead                                                                                           |
-| preset-record-jpeg               | Record live jpeg                  | Recommend restreaming live jpeg instead                                                                                              |
-| preset-record-ubiquiti           | Record ubiquiti stream with audio | Recordings with ubiquiti non-standard audio                                                                                          |
+| Preset                           | Usage                             | Other Notes                                                                                                                                                                                              |
+| -------------------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| preset-record-generic            | Record WITHOUT audio              | If your camera doesn’t have audio, or if you don’t want to record audio, use this option                                                                                                                 |
+| preset-record-generic-audio-copy | Record WITH original audio        | Use this to enable audio in recordings                                                                                                                                                                   |
+| preset-record-generic-audio-aac  | Record WITH transcoded aac audio  | This is the default when no option is specified. Use it to transcode audio to AAC. If the source is already in AAC format, use preset-record-generic-audio-copy instead to avoid unnecessary re-encoding |
+| preset-record-mjpeg              | Record an mjpeg stream            | Recommend restreaming mjpeg stream instead                                                                                                                                                               |
+| preset-record-jpeg               | Record live jpeg                  | Recommend restreaming live jpeg instead                                                                                                                                                                  |
+| preset-record-ubiquiti           | Record ubiquiti stream with audio | Recordings with ubiquiti non-standard audio                                                                                                                                                              |
@@ -21,12 +21,23 @@ genai:
  model: gemini-1.5-flash

 cameras:
-  front_camera: ...
+  front_camera: 
+    genai:
+      enabled: True # <- enable GenAI for your front camera
+      use_snapshot: True
+      objects:
+        - person
+      required_zones:
+        - steps
  indoor_camera:
-    genai: # <- disable GenAI for your indoor camera
-      enabled: False
+    genai: 
+      enabled: False # <- disable GenAI for your indoor camera
 ```

+By default, descriptions will be generated for all tracked objects and all zones. But you can also optionally specify `objects` and `required_zones` to only generate descriptions for certain tracked objects or zones.
+
+Optionally, you can generate the description using a snapshot (if enabled) by setting `use_snapshot` to `True`. By default, this is set to `False`, which sends the uncompressed images from the `detect` stream collected over the object's lifetime to the model. Once the object lifecycle ends, only a single compressed and cropped thumbnail is saved with the tracked object. Using a snapshot might be useful when you want to _regenerate_ a tracked object's description as it will provide the AI with a higher-quality image (typically downscaled by the AI itself) than the cropped/compressed thumbnail. Using a snapshot otherwise has a trade-off in that only a single image is sent to your provider, which will limit the model's ability to determine object movement or direction.
+
 ## Ollama

 :::warning
@@ -185,9 +196,7 @@ genai:
    car: "Observe the primary vehicle in these images. Focus on its movement, direction, or purpose (e.g., parking, approaching, circling). If it's a delivery vehicle, mention the company."
 ```

-Prompts can also be overriden at the camera level to provide a more detailed prompt to the model about your specific camera, if you desire. By default, descriptions will be generated for all tracked objects and all zones. But you can also optionally specify `objects` and `required_zones` to only generate descriptions for certain tracked objects or zones.
-
-Optionally, you can generate the description using a snapshot (if enabled) by setting `use_snapshot` to `True`. By default, this is set to `False`, which sends the uncompressed images from the `detect` stream collected over the object's lifetime to the model. Once the object lifecycle ends, only a single compressed and cropped thumbnail is saved with the tracked object. Using a snapshot might be useful when you want to _regenerate_ a tracked object's description as it will provide the AI with a higher-quality image (typically downscaled by the AI itself) than the cropped/compressed thumbnail. Using a snapshot otherwise has a trade-off in that only a single image is sent to your provider, which will limit the model's ability to determine object movement or direction.
+Prompts can also be overriden at the camera level to provide a more detailed prompt to the model about your specific camera, if you desire. 

 ```yaml
 cameras:
@@ -23,7 +23,7 @@ Object detection and enrichments (like Semantic Search, Face Recognition, and Li
  - Nvidia GPUs will automatically be detected and used for enrichments in the `-tensorrt` Frigate image.
  - Jetson devices will automatically be detected and used for enrichments in the `-tensorrt-jp6` Frigate image.

-Utilizing a GPU for enrichments does not require you to use the same GPU for object detection. For example, you can run the `tensorrt` Docker image for enrichments and still use other dedicated hardware for object detection.
+Utilizing a GPU for enrichments does not require you to use the same GPU for object detection. For example, you can run the `tensorrt` Docker image for enrichments and still use other dedicated hardware like a Coral or Hailo for object detection. However, one combination that is not supported is TensorRT for object detection and OpenVINO for enrichments.

 :::note

@@ -71,7 +71,8 @@ Or map in all the `/dev/video*` devices.

 | CPU Generation | Intel Driver | Recommended Preset  | Notes                                |
 | -------------- | ------------ | ------------------- | ------------------------------------ |
-| gen1 - gen7    | i965         | preset-vaapi        | qsv is not supported                 |
+| gen1 - gen5    | i965         | preset-vaapi        | qsv is not supported                 |
+| gen6 - gen7    | iHD          | preset-vaapi        | qsv is not supported                 |
 | gen8 - gen12   | iHD          | preset-vaapi        | preset-intel-qsv-\* can also be used |
 | gen13+         | iHD / Xe     | preset-intel-qsv-\* |                                      |
 | Intel Arc GPU  | iHD / Xe     | preset-intel-qsv-\* |                                      |
@@ -23,7 +23,7 @@ If you are using go2rtc, you should adjust the following settings in your camera

 - Video codec: **H.264** - provides the most compatible video codec with all Live view technologies and browsers. Avoid any kind of "smart codec" or "+" codec like _H.264+_ or _H.265+_. as these non-standard codecs remove keyframes (see below).
 - Audio codec: **AAC** - provides the most compatible audio codec with all Live view technologies and browsers that support audio.
- I-frame interval (sometimes called the keyframe interval, the interframe space, or the GOP length): match your camera's frame rate, or choose "1x" (for interframe space on Reolink cameras). For example, if your stream outputs 20fps, your i-frame interval should be 20 (or 1x on Reolink). Values higher than the frame rate will cause the stream to take longer to begin playback. See [this page](https://gardinal.net/understanding-the-keyframe-interval/) for more on keyframes. For many users this may not be an issue, but it should be noted that that a 1x i-frame interval will cause more storage utilization if you are using the stream for the `record` role as well.
+- I-frame interval (sometimes called the keyframe interval, the interframe space, or the GOP length): match your camera's frame rate, or choose "1x" (for interframe space on Reolink cameras). For example, if your stream outputs 20fps, your i-frame interval should be 20 (or 1x on Reolink). Values higher than the frame rate will cause the stream to take longer to begin playback. See [this page](https://gardinal.net/understanding-the-keyframe-interval/) for more on keyframes. For many users this may not be an issue, but it should be noted that a 1x i-frame interval will cause more storage utilization if you are using the stream for the `record` role as well.

 The default video and audio codec on your camera may not always be compatible with your browser, which is why setting them to H.264 and AAC is recommended. See the [go2rtc docs](https://github.com/AlexxIT/go2rtc?tab=readme-ov-file#codecs-madness) for codec support information.

@@ -172,7 +172,7 @@ For devices that support two way talk, Frigate can be configured to use the feat

 - Set up go2rtc with [WebRTC](#webrtc-extra-configuration).
 - Ensure you access Frigate via https (may require [opening port 8971](/frigate/installation/#ports)).
- For the Home Assistant Frigate card, [follow the docs](https://github.com/dermotduffy/frigate-hass-card?tab=readme-ov-file#using-2-way-audio) for the correct source.
+- For the Home Assistant Frigate card, [follow the docs](http://card.camera/#/usage/2-way-audio) for the correct source.

 To use the Reolink Doorbell with two way talk, you should use the [recommended Reolink configuration](/configuration/camera_specific#reolink-doorbell)

@@ -189,7 +189,12 @@ Frigate provides a dialog in the Camera Group Edit pane with several options for

 :::note

-The default dashboard ("All Cameras") will always use Smart Streaming and the first entry set in your `streams` configuration, if defined. Use a camera group if you want to change any of these settings from the defaults.
+The default dashboard ("All Cameras") will always use:
+
+- Smart Streaming, unless you've disabled the global Automatic Live View in Settings.
+- The first entry set in your `streams` configuration, if defined.
+
+Use a camera group if you want to change any of these settings from the defaults.

 :::

@@ -104,4 +104,4 @@ Lightning threshold does not stop motion based recordings from being saved.

 :::

-Large changes in motion like PTZ moves and camera switches between Color and IR mode should result in no motion detection. This is done via the `lightning_threshold` configuration. It is defined as the percentage of the image used to detect lightning or other substantial changes where motion detection needs to recalibrate. Increasing this value will make motion detection more likely to consider lightning or IR mode changes as valid motion. Decreasing this value will make motion detection more likely to ignore large amounts of motion such as a person approaching a doorbell camera.
+Large changes in motion like PTZ moves and camera switches between Color and IR mode should result in a pause in object detection. This is done via the `lightning_threshold` configuration. It is defined as the percentage of the image used to detect lightning or other substantial changes where motion detection needs to recalibrate. Increasing this value will make motion detection more likely to consider lightning or IR mode changes as valid motion. Decreasing this value will make motion detection more likely to ignore large amounts of motion such as a person approaching a doorbell camera.
@@ -24,10 +24,13 @@ Frigate supports multiple different detectors that work on different types of ha
 - [OpenVino](#openvino-detector): OpenVino can run on Intel Arc GPUs, Intel integrated GPUs, and Intel CPUs to provide efficient object detection.
 - [ONNX](#onnx): OpenVINO will automatically be detected and used as a detector in the default Frigate image when a supported ONNX model is configured.

-**Nvidia**
+**Nvidia GPU**

- [TensortRT](#nvidia-tensorrt-detector): TensorRT can run on Nvidia GPUs and Jetson devices, using one of many default models.
- [ONNX](#onnx): TensorRT will automatically be detected and used as a detector in the `-tensorrt` or `-tensorrt-jp6` Frigate images when a supported ONNX model is configured.
+- [ONNX](#onnx): TensorRT will automatically be detected and used as a detector in the `-tensorrt` Frigate image when a supported ONNX model is configured.
+
+**Nvidia Jetson**
+- [TensortRT](#nvidia-tensorrt-detector): TensorRT can run on Jetson devices, using one of many default models.
+- [ONNX](#onnx): TensorRT will automatically be detected and used as a detector in the `-tensorrt-jp6` Frigate image when a supported ONNX model is configured.

 **Rockchip**

@@ -399,111 +402,6 @@ model:

 Note that the labelmap uses a subset of the complete COCO label set that has only 80 objects.

-## NVidia TensorRT Detector
-
-Nvidia GPUs may be used for object detection using the TensorRT libraries. Due to the size of the additional libraries, this detector is only provided in images with the `-tensorrt` tag suffix, e.g. `ghcr.io/blakeblackshear/frigate:stable-tensorrt`. This detector is designed to work with Yolo models for object detection.
-
-### Minimum Hardware Support
-
-The TensorRT detector uses the 12.x series of CUDA libraries which have minor version compatibility. The minimum driver version on the host system must be `>=545`. Also the GPU must support a Compute Capability of `5.0` or greater. This generally correlates to a Maxwell-era GPU or newer, check the NVIDIA GPU Compute Capability table linked below.
-
-To use the TensorRT detector, make sure your host system has the [nvidia-container-runtime](https://docs.docker.com/config/containers/resource_constraints/#access-an-nvidia-gpu) installed to pass through the GPU to the container and the host system has a compatible driver installed for your GPU.
-
-There are improved capabilities in newer GPU architectures that TensorRT can benefit from, such as INT8 operations and Tensor cores. The features compatible with your hardware will be optimized when the model is converted to a trt file. Currently the script provided for generating the model provides a switch to enable/disable FP16 operations. If you wish to use newer features such as INT8 optimization, more work is required.
-
-#### Compatibility References:
-
-[NVIDIA TensorRT Support Matrix](https://docs.nvidia.com/deeplearning/tensorrt/archives/tensorrt-841/support-matrix/index.html)
-
-[NVIDIA CUDA Compatibility](https://docs.nvidia.com/deploy/cuda-compatibility/index.html)
-
-[NVIDIA GPU Compute Capability](https://developer.nvidia.com/cuda-gpus)
-
-### Generate Models
-
-The model used for TensorRT must be preprocessed on the same hardware platform that they will run on. This means that each user must run additional setup to generate a model file for the TensorRT library. A script is included that will build several common models.
-
-The Frigate image will generate model files during startup if the specified model is not found. Processed models are stored in the `/config/model_cache` folder. Typically the `/config` path is mapped to a directory on the host already and the `model_cache` does not need to be mapped separately unless the user wants to store it in a different location on the host.
-
-By default, no models will be generated, but this can be overridden by specifying the `YOLO_MODELS` environment variable in Docker. One or more models may be listed in a comma-separated format, and each one will be generated. Models will only be generated if the corresponding `{model}.trt` file is not present in the `model_cache` folder, so you can force a model to be regenerated by deleting it from your Frigate data folder.
-
-If you have a Jetson device with DLAs (Xavier or Orin), you can generate a model that will run on the DLA by appending `-dla` to your model name, e.g. specify `YOLO_MODELS=yolov7-320-dla`. The model will run on DLA0 (Frigate does not currently support DLA1). DLA-incompatible layers will fall back to running on the GPU.
-
-If your GPU does not support FP16 operations, you can pass the environment variable `USE_FP16=False` to disable it.
-
-Specific models can be selected by passing an environment variable to the `docker run` command or in your `docker-compose.yml` file. Use the form `-e YOLO_MODELS=yolov4-416,yolov4-tiny-416` to select one or more model names. The models available are shown below.
-
-<details>
-<summary>Available Models</summary>
-```
-yolov3-288
-yolov3-416
-yolov3-608
-yolov3-spp-288
-yolov3-spp-416
-yolov3-spp-608
-yolov3-tiny-288
-yolov3-tiny-416
-yolov4-288
-yolov4-416
-yolov4-608
-yolov4-csp-256
-yolov4-csp-512
-yolov4-p5-448
-yolov4-p5-896
-yolov4-tiny-288
-yolov4-tiny-416
-yolov4x-mish-320
-yolov4x-mish-640
-yolov7-tiny-288
-yolov7-tiny-416
-yolov7-640
-yolov7-416
-yolov7-320
-yolov7x-640
-yolov7x-320
-```
-</details>
-
-An example `docker-compose.yml` fragment that converts the `yolov4-608` and `yolov7x-640` models for a Pascal card would look something like this:
-
-```yml
-frigate:
-  environment:
-    - YOLO_MODELS=yolov7-320,yolov7x-640
-    - USE_FP16=false
-```
-
-If you have multiple GPUs passed through to Frigate, you can specify which one to use for the model conversion. The conversion script will use the first visible GPU, however in systems with mixed GPU models you may not want to use the default index for object detection. Add the `TRT_MODEL_PREP_DEVICE` environment variable to select a specific GPU.
-
-```yml
-frigate:
-  environment:
-    - TRT_MODEL_PREP_DEVICE=0 # Optionally, select which GPU is used for  model optimization
-```
-
-### Configuration Parameters
-
-The TensorRT detector can be selected by specifying `tensorrt` as the model type. The GPU will need to be passed through to the docker container using the same methods described in the [Hardware Acceleration](hardware_acceleration_video.md#nvidia-gpus) section. If you pass through multiple GPUs, you can select which GPU is used for a detector with the `device` configuration parameter. The `device` parameter is an integer value of the GPU index, as shown by `nvidia-smi` within the container.
-
-The TensorRT detector uses `.trt` model files that are located in `/config/model_cache/tensorrt` by default. These model path and dimensions used will depend on which model you have generated.
-
-Use the config below to work with generated TRT models:
-
-```yaml
-detectors:
-  tensorrt:
-    type: tensorrt
-    device: 0 #This is the default, select the first GPU
-
-model:
-  path: /config/model_cache/tensorrt/yolov7-320.trt
-  input_tensor: nchw
-  input_pixel_format: rgb
-  width: 320
-  height: 320
-```
-
 ## AMD/ROCm GPU detector

 ### Setup
@@ -801,6 +699,88 @@ To verify that the integration is working correctly, start Frigate and observe t

 # Community Supported Detectors

+## NVidia TensorRT Detector
+
+Nvidia Jetson devices may be used for object detection using the TensorRT libraries. Due to the size of the additional libraries, this detector is only provided in images with the `-tensorrt-jp6` tag suffix, e.g. `ghcr.io/blakeblackshear/frigate:stable-tensorrt-jp6`. This detector is designed to work with Yolo models for object detection.
+
+### Generate Models
+
+The model used for TensorRT must be preprocessed on the same hardware platform that they will run on. This means that each user must run additional setup to generate a model file for the TensorRT library. A script is included that will build several common models.
+
+The Frigate image will generate model files during startup if the specified model is not found. Processed models are stored in the `/config/model_cache` folder. Typically the `/config` path is mapped to a directory on the host already and the `model_cache` does not need to be mapped separately unless the user wants to store it in a different location on the host.
+
+By default, no models will be generated, but this can be overridden by specifying the `YOLO_MODELS` environment variable in Docker. One or more models may be listed in a comma-separated format, and each one will be generated. Models will only be generated if the corresponding `{model}.trt` file is not present in the `model_cache` folder, so you can force a model to be regenerated by deleting it from your Frigate data folder.
+
+If you have a Jetson device with DLAs (Xavier or Orin), you can generate a model that will run on the DLA by appending `-dla` to your model name, e.g. specify `YOLO_MODELS=yolov7-320-dla`. The model will run on DLA0 (Frigate does not currently support DLA1). DLA-incompatible layers will fall back to running on the GPU.
+
+If your GPU does not support FP16 operations, you can pass the environment variable `USE_FP16=False` to disable it.
+
+Specific models can be selected by passing an environment variable to the `docker run` command or in your `docker-compose.yml` file. Use the form `-e YOLO_MODELS=yolov4-416,yolov4-tiny-416` to select one or more model names. The models available are shown below.
+
+<details>
+<summary>Available Models</summary>
+```
+yolov3-288
+yolov3-416
+yolov3-608
+yolov3-spp-288
+yolov3-spp-416
+yolov3-spp-608
+yolov3-tiny-288
+yolov3-tiny-416
+yolov4-288
+yolov4-416
+yolov4-608
+yolov4-csp-256
+yolov4-csp-512
+yolov4-p5-448
+yolov4-p5-896
+yolov4-tiny-288
+yolov4-tiny-416
+yolov4x-mish-320
+yolov4x-mish-640
+yolov7-tiny-288
+yolov7-tiny-416
+yolov7-640
+yolov7-416
+yolov7-320
+yolov7x-640
+yolov7x-320
+```
+</details>
+
+An example `docker-compose.yml` fragment that converts the `yolov4-608` and `yolov7x-640` models would look something like this:
+
+```yml
+frigate:
+  environment:
+    - YOLO_MODELS=yolov7-320,yolov7x-640
+    - USE_FP16=false
+```
+
+### Configuration Parameters
+
+The TensorRT detector can be selected by specifying `tensorrt` as the model type. The GPU will need to be passed through to the docker container using the same methods described in the [Hardware Acceleration](hardware_acceleration_video.md#nvidia-gpus) section. If you pass through multiple GPUs, you can select which GPU is used for a detector with the `device` configuration parameter. The `device` parameter is an integer value of the GPU index, as shown by `nvidia-smi` within the container.
+
+The TensorRT detector uses `.trt` model files that are located in `/config/model_cache/tensorrt` by default. These model path and dimensions used will depend on which model you have generated.
+
+Use the config below to work with generated TRT models:
+
+```yaml
+detectors:
+  tensorrt:
+    type: tensorrt
+    device: 0 #This is the default, select the first GPU
+
+model:
+  path: /config/model_cache/tensorrt/yolov7-320.trt
+  labelmap_path: /labelmap/coco-80.txt
+  input_tensor: nchw
+  input_pixel_format: rgb
+  width: 320
+  height: 320
+```
+
 ## Rockchip platform

 Hardware accelerated object detection is supported on the following SoCs:
@@ -20,5 +20,5 @@ In order to install Frigate as a PWA, the following requirements must be met:
 Installation varies slightly based on the device that is being used:

 - Desktop: Use the install button typically found in right edge of the address bar
- Android: Use the `Install as App` button in the more options menu
- iOS: Use the `Add to Homescreen` button in the share menu
+- Android: Use the `Install as App` button in the more options menu for Chrome, and the `Add app to Home screen` button for Firefox
+- iOS: Use the `Add to Homescreen` button in the share menu
@@ -561,7 +561,7 @@ face_recognition:
  recognition_threshold: 0.9
  # Optional: Min area of detected face box to consider running face recognition (default: shown below)
  min_area: 500
-  # Optional: Min face attempts for the sub label to be applied to the person object (default: shown below)
+  # Optional: Min face recognitions for the sub label to be applied to the person object (default: shown below)
  min_faces: 1
  # Optional: Number of images of recognized faces to save for training (default: shown below)
  save_attempts: 100
@@ -21,6 +21,21 @@ In 0.14 and later, all of that is bundled into a single review item which starts

 Not every segment of video captured by Frigate may be of the same level of interest to you. Video of people who enter your property may be a different priority than those walking by on the sidewalk. For this reason, Frigate 0.14 categorizes review items as _alerts_ and _detections_. By default, all person and car objects are considered alerts. You can refine categorization of your review items by configuring required zones for them.

+:::note
+
+Alerts and detections categorize the tracked objects in review items, but Frigate must first detect those objects with your configured object detector (Coral, OpenVINO, etc). By default, the object tracker only detects `person`. Setting `labels` for `alerts` and `detections` does not automatically enable detection of new objects. To detect more than `person`, you should add the following to your config:
+
+```yaml
+objects:
+  track:
+    - person
+    - car
+    - ...
+```
+
+See the [objects documentation](objects.md) for the list of objects that Frigate's default model tracks.
+:::
+
 ## Restricting alerts to specific labels

 By default a review item will only be marked as an alert if a person or car is detected. This can be configured to include any object or audio label using the following config:
@@ -36,8 +36,8 @@ Note that certbot uses symlinks, and those can't be followed by the container un
 frigate:
  ...
  volumes:
-    - /etc/letsencrypt/live/frigate:/etc/letsencrypt/live/frigate:ro
-    - /etc/letsencrypt/archive/frigate:/etc/letsencrypt/archive/frigate:ro
+    - /etc/letsencrypt/live/your.fqdn.net:/etc/letsencrypt/live/frigate:ro
+    - /etc/letsencrypt/archive/your.fqdn.net:/etc/letsencrypt/archive/your.fqdn.net:ro
  ...

 ```
@@ -3,7 +3,7 @@ id: camera_setup
 title: Camera setup
 ---

-Cameras configured to output H.264 video and AAC audio will offer the most compatibility with all features of Frigate and Home Assistant. H.265 has better compression, but less compatibility. Chrome 108+, Safari and Edge are the only browsers able to play H.265 and only support a limited number of H.265 profiles. Ideally, cameras should be configured directly for the desired resolutions and frame rates you want to use in Frigate. Reducing frame rates within Frigate will waste CPU resources decoding extra frames that are discarded. There are three different goals that you want to tune your stream configurations around.
+Cameras configured to output H.264 video and AAC audio will offer the most compatibility with all features of Frigate and Home Assistant. H.265 has better compression, but less compatibility. Firefox 134+/136+/137+ (Windows/Mac/Linux & Android), Chrome 108+, Safari and Edge are the only browsers able to play H.265 and only support a limited number of H.265 profiles. Ideally, cameras should be configured directly for the desired resolutions and frame rates you want to use in Frigate. Reducing frame rates within Frigate will waste CPU resources decoding extra frames that are discarded. There are three different goals that you want to tune your stream configurations around.

 - **Detection**: This is the only stream that Frigate will decode for processing. Also, this is the stream where snapshots will be generated from. The resolution for detection should be tuned for the size of the objects you want to detect. See [Choosing a detect resolution](#choosing-a-detect-resolution) for more details. The recommended frame rate is 5fps, but may need to be higher (10fps is the recommended maximum for most users) for very fast moving objects. Higher resolutions and frame rates will drive higher CPU usage on your server.

@@ -66,4 +66,4 @@ The time period starting when a tracked object entered the frame and ending when

 ## Zone

-Zones are areas of interest, zones can be used for notifications and for limiting the areas where Frigate will create an [event](#event). [See the zone docs for more info](/configuration/zones)
+Zones are areas of interest, zones can be used for notifications and for limiting the areas where Frigate will create a [review item](#review-item). [See the zone docs for more info](/configuration/zones)
@@ -9,23 +9,36 @@ Cameras that output H.264 video and AAC audio will offer the most compatibility

 I recommend Dahua, Hikvision, and Amcrest in that order. Dahua edges out Hikvision because they are easier to find and order, not because they are better cameras. I personally use Dahua cameras because they are easier to purchase directly. In my experience Dahua and Hikvision both have multiple streams with configurable resolutions and frame rates and rock solid streams. They also both have models with large sensors well known for excellent image quality at night. Not all the models are equal. Larger sensors are better than higher resolutions; especially at night. Amcrest is the fallback recommendation because they are rebranded Dahuas. They are rebranding the lower end models with smaller sensors or less configuration options.

-Many users have reported various issues with Reolink cameras, so I do not recommend them. If you are using Reolink, I suggest the [Reolink specific configuration](../configuration/camera_specific.md#reolink-cameras). Wifi cameras are also not recommended. Their streams are less reliable and cause connection loss and/or lost video data.
+WiFi cameras are not recommended as [their streams are less reliable and cause connection loss and/or lost video data](https://ipcamtalk.com/threads/camera-conflicts.68142/#post-738821), especially when more than a few WiFi cameras will be used at the same time.

-Here are some of the camera's I recommend:
+Many users have reported various issues with 4K-plus Reolink cameras, it is best to stick with 5MP and lower for Reolink cameras. If you are using Reolink, I suggest the [Reolink specific configuration](../configuration/camera_specific.md#reolink-cameras).
+
+Here are some of the cameras I recommend:

 - <a href="https://amzn.to/4fwoNWA" target="_blank" rel="nofollow noopener sponsored">Loryta(Dahua) IPC-T549M-ALED-S3</a> (affiliate link)
 - <a href="https://amzn.to/3YXpcMw" target="_blank" rel="nofollow noopener sponsored">Loryta(Dahua) IPC-T54IR-AS</a> (affiliate link)
 - <a href="https://amzn.to/3AvBHoY" target="_blank" rel="nofollow noopener sponsored">Amcrest IP5M-T1179EW-AI-V3</a> (affiliate link)
+- <a href="https://amzn.to/4ltOpaC" target="_blank" rel="nofollow noopener sponsored">HIKVISION DS-2CD2387G2P-LSU/SL ColorVu 8MP Panoramic Turret IP Camera</a> (affiliate link)

 I may earn a small commission for my endorsement, recommendation, testimonial, or link to any products or services from this website.

 ## Server

-My current favorite is the Beelink EQ13 because of the efficient N100 CPU and dual NICs that allow you to setup a dedicated private network for your cameras where they can be blocked from accessing the internet. There are many used workstation options on eBay that work very well. Anything with an Intel CPU and capable of running Debian should work fine. As a bonus, you may want to look for devices with a M.2 or PCIe express slot that is compatible with the Hailo8 or Google Coral. I may earn a small commission for my endorsement, recommendation, testimonial, or link to any products or services from this website.
+My current favorite is the Beelink EQ13 because of the efficient N100 CPU and dual NICs that allow you to setup a dedicated private network for your cameras where they can be blocked from accessing the internet. There are many used workstation options on eBay that work very well. Anything with an Intel CPU and capable of running Debian should work fine. As a bonus, you may want to look for devices with a M.2 or PCIe express slot that is compatible with the Google Coral, Hailo, or other AI accelerators.

-| Name                                                                                                          | Notes                                                                                     |
-| ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
-| Beelink EQ13 (<a href="https://amzn.to/4iQaBKu" target="_blank" rel="nofollow noopener sponsored">Amazon</a>) | Dual gigabit NICs for easy isolated camera network. Easily handles several 1080p cameras. |
+Note that many of these mini PCs come with Windows pre-installed, and you will need to install Linux according to the [getting started guide](../guides/getting_started.md).
+
+I may earn a small commission for my endorsement, recommendation, testimonial, or link to any products or services from this website.
+
+:::warning
+
+If the EQ13 is out of stock, the link below may take you to a suggested alternative on Amazon. The Beelink EQ14 has some known compatibility issues, so you should avoid that model for now.
+
+:::
+
+| Name                                                                                                          | Coral Inference Speed | Coral Compatibility | Notes                                                                                     |
+| ------------------------------------------------------------------------------------------------------------- | --------------------- | ------------------- | ----------------------------------------------------------------------------------------- |
+| Beelink EQ13 (<a href="https://amzn.to/4jn2qVr" target="_blank" rel="nofollow noopener sponsored">Amazon</a>) | 5-10ms                | USB                 | Dual gigabit NICs for easy isolated camera network. Easily handles several 1080p cameras. |

 ## Detectors

@@ -116,14 +129,30 @@ Inference speeds vary greatly depending on the CPU or GPU used, some known examp
 | Intel HD 630   | ~ 15 ms                    | 320: ~ 30 ms              |                        |                                    |
 | Intel UHD 730  | ~ 10 ms                    | 320: ~ 19 ms 640: ~ 54 ms |                        |                                    |
 | Intel UHD 770  | ~ 15 ms                    | 320: ~ 20 ms 640: ~ 46 ms |                        |                                    |
-| Intel N100     | ~ 15 ms                    | 320: ~ 20 ms              |                        |                                    |
+| Intel N100     | ~ 15 ms                    | 320: ~ 25 ms              |                        | Can only run one detector instance |
 | Intel Iris XE  | ~ 10 ms                    | 320: ~ 18 ms 640: ~ 50 ms |                        |                                    |
 | Intel Arc A380 | ~ 6 ms                     | 320: ~ 10 ms 640: ~ 22 ms | 336: 20 ms 448: 27 ms  |                                    |
 | Intel Arc A750 | ~ 4 ms                     | 320: ~ 8 ms               |                        |                                    |

 ### TensorRT - Nvidia GPU

-The TensortRT detector is able to run on x86 hosts that have an Nvidia GPU which supports the 12.x series of CUDA libraries. The minimum driver version on the host system must be `>=525.60.13`. Also the GPU must support a Compute Capability of `5.0` or greater. This generally correlates to a Maxwell-era GPU or newer, check the [TensorRT docs for more info](/configuration/object_detectors#nvidia-tensorrt-detector).
+Frigate is able to utilize an Nvidia GPU which supports the 12.x series of CUDA libraries.
+
+### Minimum Hardware Support
+
+ 12.x series of CUDA libraries are used which have minor version compatibility. The minimum driver version on the host system must be `>=545`. Also the GPU must support a Compute Capability of `5.0` or greater. This generally correlates to a Maxwell-era GPU or newer, check the NVIDIA GPU Compute Capability table linked below.
+
+Make sure your host system has the [nvidia-container-runtime](https://docs.docker.com/config/containers/resource_constraints/#access-an-nvidia-gpu) installed to pass through the GPU to the container and the host system has a compatible driver installed for your GPU.
+
+There are improved capabilities in newer GPU architectures that TensorRT can benefit from, such as INT8 operations and Tensor cores. The features compatible with your hardware will be optimized when the model is converted to a trt file. Currently the script provided for generating the model provides a switch to enable/disable FP16 operations. If you wish to use newer features such as INT8 optimization, more work is required.
+
+#### Compatibility References:
+
+[NVIDIA TensorRT Support Matrix](https://docs.nvidia.com/deeplearning/tensorrt/archives/tensorrt-841/support-matrix/index.html)
+
+[NVIDIA CUDA Compatibility](https://docs.nvidia.com/deploy/cuda-compatibility/index.html)
+
+[NVIDIA GPU Compute Capability](https://developer.nvidia.com/cuda-gpus)

 Inference speeds will vary greatly depending on the GPU and the model used.
 `tiny` variants are faster than the equivalent non-tiny model, some known examples are below:
@@ -193,4 +222,4 @@ Basically - When you increase the resolution and/or the frame rate of the stream

 YES! The Coral does not help with decoding video streams.

-Decompressing video streams takes a significant amount of CPU power. Video compression uses key frames (also known as I-frames) to send a full frame in the video stream. The following frames only include the difference from the key frame, and the CPU has to compile each frame by merging the differences with the key frame. [More detailed explanation](https://blog.video.ibm.com/streaming-video-tips/keyframes-interframe-video-compression/). Higher resolutions and frame rates mean more processing power is needed to decode the video stream, so try and set them on the camera to avoid unnecessary decoding work.
+Decompressing video streams takes a significant amount of CPU power. Video compression uses key frames (also known as I-frames) to send a full frame in the video stream. The following frames only include the difference from the key frame, and the CPU has to compile each frame by merging the differences with the key frame. [More detailed explanation](https://support.video.ibm.com/hc/en-us/articles/18106203580316-Keyframes-InterFrame-Video-Compression). Higher resolutions and frame rates mean more processing power is needed to decode the video stream, so try and set them on the camera to avoid unnecessary decoding work.
@@ -145,7 +145,7 @@ $ sudo cat /sys/kernel/debug/rknpu/version
 RKNPU driver: v0.9.2 # or later version
 ```

-I recommend [Joshua Riek's Ubuntu for Rockchip](https://github.com/Joshua-Riek/ubuntu-rockchip), if your board is supported.
+I recommend [Armbian](https://www.armbian.com/download/?arch=aarch64), if your board is supported.

 #### Setup

@@ -0,0 +1,119 @@
+---
+id: updating
+title: Updating
+---
+
+# Updating Frigate
+
+The current stable version of Frigate is **0.15.0**. The release notes and any breaking changes for this version can be found on the [Frigate GitHub releases page](https://github.com/blakeblackshear/frigate/releases/tag/v0.15.0).
+
+Keeping Frigate up to date ensures you benefit from the latest features, performance improvements, and bug fixes. The update process varies slightly depending on your installation method (Docker, Home Assistant Addon, etc.). Below are instructions for the most common setups.
+
+## Before You Begin
+
+- **Stop Frigate**: For most methods, you’ll need to stop the running Frigate instance before backing up and updating.
+- **Backup Your Configuration**: Always back up your `/config` directory (e.g., `config.yml` and `frigate.db`, the SQLite database) before updating. This ensures you can roll back if something goes wrong.
+- **Check Release Notes**: Carefully review the [Frigate GitHub releases page](https://github.com/blakeblackshear/frigate/releases) for breaking changes or configuration updates that might affect your setup.
+
+## Updating with Docker
+
+If you’re running Frigate via Docker (recommended method), follow these steps:
+
+1. **Stop the Container**:
+
+   - If using Docker Compose:
+     ```bash
+     docker compose down frigate
+     ```
+   - If using `docker run`:
+     ```bash
+     docker stop frigate
+     ```
+
+2. **Update and Pull the Latest Image**:
+
+   - If using Docker Compose:
+     - Edit your `docker-compose.yml` file to specify the desired version tag (e.g., `0.15.0` instead of `0.14.1`). For example:
+       ```yaml
+       services:
+         frigate:
+           image: ghcr.io/blakeblackshear/frigate:0.15.0
+       ```
+     - Then pull the image:
+       ```bash
+       docker pull ghcr.io/blakeblackshear/frigate:0.15.0
+       ```
+     - **Note for `stable` Tag Users**: If your `docker-compose.yml` uses the `stable` tag (e.g., `ghcr.io/blakeblackshear/frigate:stable`), you don’t need to update the tag manually. The `stable` tag always points to the latest stable release after pulling.
+   - If using `docker run`:
+     - Pull the image with the appropriate tag (e.g., `0.15.0`, `0.15.0-tensorrt`, or `stable`):
+       ```bash
+       docker pull ghcr.io/blakeblackshear/frigate:0.15.0
+       ```
+
+3. **Start the Container**:
+
+   - If using Docker Compose:
+     ```bash
+     docker compose up -d
+     ```
+   - If using `docker run`, re-run your original command (e.g., from the [Installation](./installation.md#docker) section) with the updated image tag.
+
+4. **Verify the Update**:
+   - Check the container logs to ensure Frigate starts successfully:
+     ```bash
+     docker logs frigate
+     ```
+   - Visit the Frigate Web UI (default: `http://<your-ip>:5000`) to confirm the new version is running. The version number is displayed at the top of the System Metrics page.
+
+### Notes
+
+- If you’ve customized other settings (e.g., `shm-size`), ensure they’re still appropriate after the update.
+- Docker will automatically use the updated image when you restart the container, as long as you pulled the correct version.
+
+## Updating the Home Assistant Addon
+
+For users running Frigate as a Home Assistant Addon:
+
+1. **Check for Updates**:
+
+   - Navigate to **Settings > Add-ons** in Home Assistant.
+   - Find your installed Frigate addon (e.g., "Frigate NVR" or "Frigate NVR (Full Access)").
+   - If an update is available, you’ll see an "Update" button.
+
+2. **Update the Addon**:
+
+   - Click the "Update" button next to the Frigate addon.
+   - Wait for the process to complete. Home Assistant will handle downloading and installing the new version.
+
+3. **Restart the Addon**:
+
+   - After updating, go to the addon’s page and click "Restart" to apply the changes.
+
+4. **Verify the Update**:
+   - Check the addon logs (under the "Log" tab) to ensure Frigate starts without errors.
+   - Access the Frigate Web UI to confirm the new version is running.
+
+### Notes
+
+- Ensure your `/config/frigate.yml` is compatible with the new version by reviewing the [Release notes](https://github.com/blakeblackshear/frigate/releases).
+- If using custom hardware (e.g., Coral or GPU), verify that configurations still work, as addon updates don’t modify your hardware settings.
+
+## Rolling Back
+
+If an update causes issues:
+
+1. Stop Frigate.
+2. Restore your backed-up config file and database.
+3. Revert to the previous image version:
+   - For Docker: Specify an older tag (e.g., `ghcr.io/blakeblackshear/frigate:0.14.1`) in your `docker run` command.
+   - For Docker Compose: Edit your `docker-compose.yml`, specify the older version tag (e.g., `ghcr.io/blakeblackshear/frigate:0.14.1`), and re-run `docker compose up -d`.
+   - For Home Assistant: Reinstall the previous addon version manually via the repository if needed and restart the addon.
+4. Verify the old version is running again.
+
+## Troubleshooting
+
+- **Container Fails to Start**: Check logs (`docker logs frigate`) for errors.
+- **UI Not Loading**: Ensure ports (e.g., 5000, 8971) are still mapped correctly and the service is running.
+- **Hardware Issues**: Revisit hardware-specific setup (e.g., Coral, GPU) if detection or decoding fails post-update.
+
+Common questions are often answered in the [FAQ](https://github.com/blakeblackshear/frigate/discussions), pinned at the top of the support discussions.
@@ -35,6 +35,7 @@ There are many solutions available to implement reverse proxies and the communit
 * [Apache2](#apache2-reverse-proxy)
 * [Nginx](#nginx-reverse-proxy)
 * [Traefik](#traefik-reverse-proxy)
+* [Caddy](#caddy-reverse-proxy)

 ## Apache2 Reverse Proxy

@@ -117,7 +118,8 @@ server {
  set $port           8971;

  listen 80;
-  listen 443 ssl http2;
+  listen 443 ssl;
+  http2 on;

  server_name frigate.domain.com;
 }
@@ -177,3 +179,33 @@ The above configuration will create a "service" in Traefik, automatically adding
 It will also add a router, routing requests to "traefik.example.com" to your local container.

 Note that with this approach, you don't need to expose any ports for the Frigate instance since all traffic will be routed over the internal Docker network.
+
+## Caddy Reverse Proxy
+
+This example shows Frigate running under a subdomain with logging and a tls cert (in this case a wildcard domain cert obtained independently of caddy) handled via imports
+
+```caddy
+(logging) {
+        log {
+                output file /var/log/caddy/{args[0]}.log {
+                        roll_size 10MiB
+                        roll_keep 5
+                        roll_keep_for 10d
+                }
+                format json
+                level INFO
+        }
+}
+
+
+(tls) {
+        tls /var/lib/caddy/wildcard.YOUR_DOMAIN.TLD.fullchain.pem /var/lib/caddy/wildcard.YOUR_DOMAIN.TLD.privkey.pem
+}
+
+frigate.YOUR_DOMAIN.TLD {
+        reverse_proxy http://localhost:8971 
+        import tls
+        import logging frigate.YOUR_DOMAIN.TLD
+}
+
+```
@@ -110,6 +110,14 @@ If you run Frigate on a separate device within your local network, Home Assistan

 Use `http://<frigate_device_ip>:8971` as the URL for the integration so that authentication is required.

+:::tip
+
+The above URL assumes you have [disabled TLS](../configuration/tls).
+By default, TLS is enabled and Frigate will be using a self-signed certificate. HomeAssistant will fail to connect HTTPS to port 8971 since it fails to verify the self-signed certificate.
+Either disable TLS and use HTTP from HomeAssistant, or configure Frigate to be acessible with a valid certificate.
+
+:::
+
 ```yaml
 services:
  frigate:
@@ -28,7 +28,14 @@ Message published for each changed tracked object. The first message is publishe
    "id": "1607123955.475377-mxklsc",
    "camera": "front_door",
    "frame_time": 1607123961.837752,
-    "snapshot_time": 1607123961.837752,
+    "snapshot": {
+        "frame_time": 1607123965.975463,
+        "box": [415, 489, 528, 700],
+        "area": 12728,
+        "region": [260, 446, 660, 846],
+        "score": 0.77546,
+        "attributes": [],
+    },
    "label": "person",
    "sub_label": null,
    "top_score": 0.958984375,
@@ -62,7 +69,14 @@ Message published for each changed tracked object. The first message is publishe
    "id": "1607123955.475377-mxklsc",
    "camera": "front_door",
    "frame_time": 1607123962.082975,
-    "snapshot_time": 1607123961.837752,
+    "snapshot": {
+        "frame_time": 1607123965.975463,
+        "box": [415, 489, 528, 700],
+        "area": 12728,
+        "region": [260, 446, 660, 846],
+        "score": 0.77546,
+        "attributes": [],
+    },
    "label": "person",
    "sub_label": ["John Smith", 0.79],
    "top_score": 0.958984375,
@@ -43,7 +43,7 @@ Snapshots must be enabled to be able to submit examples to Frigate+

 ### Annotate and verify

-You can view all of your submitted images at [https://plus.frigate.video](https://plus.frigate.video). Annotations can be added by clicking an image. For more detailed information about labeling, see the documentation on [improving your model](../plus/improving_model.md).
+You can view all of your submitted images at [https://plus.frigate.video](https://plus.frigate.video). Annotations can be added by clicking an image. For more detailed information about labeling, see the documentation on [annotating](../plus/annotating.md).

 ![Annotate](/img/annotate.png)

@@ -13,6 +13,10 @@ Please use your own knowledge to assess and vet them before you install anything

 :::

+## [Advanced Camera Card (formerly known as Frigate Card](https://card.camera/#/README)
+
+The [Advanced Camera Card](https://card.camera/#/README) is a Home Assistant dashboard card with deep Frigate integration.
+
 ## [Double Take](https://github.com/skrashevich/double-take)

 [Double Take](https://github.com/skrashevich/double-take) provides an unified UI and API for processing and training images for facial recognition.
@@ -23,6 +27,10 @@ This is a fork (with fixed errors and new features) of [original Double Take](ht

 [Frigate Notify](https://github.com/0x2142/frigate-notify) is a simple app designed to send notifications from Frigate to your favorite platforms. Intended to be used with standalone Frigate installations - Home Assistant not required, MQTT is optional but recommended.

+## [Frigate Snap-Sync](https://github.com/thequantumphysicist/frigate-snap-sync/)
+
+[Frigate Snap-Sync](https://github.com/thequantumphysicist/frigate-snap-sync/) is a program that works in tandem with Frigate. It responds to Frigate when a snapshot or a review is made (and more can be added), and uploads them to one or more remote server(s) of your choice.
+
 ## [Frigate telegram](https://github.com/OldTyT/frigate-telegram)

 [Frigate telegram](https://github.com/OldTyT/frigate-telegram) makes it possible to send events from Frigate to Telegram. Events are sent as a message with a text description, video, and thumbnail.
@@ -1,17 +1,9 @@
 ---
-id: improving_model
-title: Improving your model
+id: annotating
+title: Annotating your images
 ---

-You may find that Frigate+ models result in more false positives initially, but by submitting true and false positives, the model will improve. With all the new images now being submitted by subscribers, future base models will improve as more and more examples are incorporated. Note that only images with at least one verified label will be used when training your model. Submitting an image from Frigate as a true or false positive will not verify the image. You still must verify the image in Frigate+ in order for it to be used in training.
-
- **Submit both true positives and false positives**. This will help the model differentiate between what is and isn't correct. You should aim for a target of 80% true positive submissions and 20% false positives across all of your images. If you are experiencing false positives in a specific area, submitting true positives for any object type near that area in similar lighting conditions will help teach the model what that area looks like when no objects are present.
- **Lower your thresholds a little in order to generate more false/true positives near the threshold value**. For example, if you have some false positives that are scoring at 68% and some true positives scoring at 72%, you can try lowering your threshold to 65% and submitting both true and false positives within that range. This will help the model learn and widen the gap between true and false positive scores.
- **Submit diverse images**. For the best results, you should provide at least 100 verified images per camera. Keep in mind that varying conditions should be included. You will want images from cloudy days, sunny days, dawn, dusk, and night. As circumstances change, you may need to submit new examples to address new types of false positives. For example, the change from summer days to snowy winter days or other changes such as a new grill or patio furniture may require additional examples and training.
-
-## Properly labeling images
-
-For the best results, follow the following guidelines.
+For the best results, follow these guidelines. You may also want to review the documentation on [improving your model](./index.md#improving-your-model).

 **Label every object in the image**: It is important that you label all objects in each image before verifying. If you don't label a car for example, the model will be taught that part of the image is _not_ a car and it will start to get confused. You can exclude labels that you don't want detected on any of your cameras.

@@ -25,9 +17,17 @@ For the best results, follow the following guidelines.

 ![Fedex Logo](/img/plus/fedex-logo.jpg)

+## AI suggested labels
+
+If you have an active Frigate+ subscription, new uploads will be scanned for the objects configured for you camera and you will see suggested labels as light blue boxes when annotating in Frigate+. These suggestions are processed via a queue and typically complete within a minute after uploading, but processing times can be longer.
+
+![Suggestions](/img/plus/suggestions.webp)
+
+Suggestions are converted to labels when saving, so you should remove any errant suggestions. There is already some logic designed to avoid duplicate labels, but you may still occasionally see some duplicate suggestions. You should keep the most accurate bounding box and delete any duplicates so that you have just one label per object remaining.
+
 ## False positive labels

-False positives will be shown with a read box and the label will have a strike through.
+False positives will be shown with a read box and the label will have a strike through. These can't be adjusted, but they can be deleted if you accidentally submit a true positive as a false positive from Frigate.
 ![false positive](/img/plus/false-positive.jpg)

 Misidentified objects should have a correct label added. For example, if a person was mistakenly detected as a cat, you should submit it as a false positive in Frigate and add a label for the person. The boxes will overlap.
@@ -9,11 +9,11 @@ Before requesting your first model, you will need to upload and verify at least

 It is recommended to submit **both** true positives and false positives. This will help the model differentiate between what is and isn't correct. You should aim for a target of 80% true positive submissions and 20% false positives across all of your images. If you are experiencing false positives in a specific area, submitting true positives for any object type near that area in similar lighting conditions will help teach the model what that area looks like when no objects are present.

-For more detailed recommendations, you can refer to the docs on [improving your model](./improving_model.md).
+For more detailed recommendations, you can refer to the docs on [annotating](./annotating.md).

 ## Step 2: Submit a model request

-Once you have an initial set of verified images, you can request a model on the Models page. For guidance on choosing a model type, refer to [this part of the documentation](./index.md#available-model-types). Each model request requires 1 of the 12 trainings that you receive with your annual subscription. This model will support all [label types available](./index.md#available-label-types) even if you do not submit any examples for those labels. Model creation can take up to 36 hours.
+Once you have an initial set of verified images, you can request a model on the Models page. For guidance on choosing a model type, refer to [this part of the documentation](./index.md#available-model-types). If you are unsure which type to request, you can test the base model for each version from the "Base Models" tab. Each model request requires 1 of the 12 trainings that you receive with your annual subscription. This model will support all [label types available](./index.md#available-label-types) even if you do not submit any examples for those labels. Model creation can take up to 36 hours.
 ![Plus Models Page](/img/plus/plus-models.jpg)

 ## Step 3: Set your model id in the config
@@ -3,15 +3,9 @@ id: index
 title: Models
 ---

-<a href="https://frigate.video/plus" target="_blank" rel="nofollow">Frigate+</a> offers models trained on images submitted by Frigate+ users from their security cameras and is specifically designed for the way Frigate analyzes video footage. These models offer higher accuracy with less resources. The images you upload are used to fine tune a baseline model trained from images uploaded by all Frigate+ users. This fine tuning process results in a model that is optimized for accuracy in your specific conditions.
+<a href="https://frigate.video/plus" target="_blank" rel="nofollow">Frigate+</a> offers models trained on images submitted by Frigate+ users from their security cameras and is specifically designed for the way Frigate NVR analyzes video footage. These models offer higher accuracy with less resources. The images you upload are used to fine tune a base model trained from images uploaded by all Frigate+ users. This fine tuning process results in a model that is optimized for accuracy in your specific conditions.

-:::info
-
-The baseline model isn't directly available after subscribing. This may change in the future, but for now you will need to submit a model request with the minimum number of images.
-
-:::
-
-With a subscription, 12 model trainings per year are included. If you cancel your subscription, you will retain access to any trained models. An active subscription is required to submit model requests or purchase additional trainings.
+With a subscription, 12 model trainings to fine tune your model per year are included. In addition, you will have access to any base models published while your subscription is active. If you cancel your subscription, you will retain access to any trained and base models in your account. An active subscription is required to submit model requests or purchase additional trainings. New base models are published quarterly with target dates of January 15th, April 15th, July 15th, and October 15th.

 Information on how to integrate Frigate+ with Frigate can be found in the [integration docs](../integrations/plus.md).

@@ -19,7 +13,7 @@ Information on how to integrate Frigate+ with Frigate can be found in the [integ

 There are two model types offered in Frigate+, `mobiledet` and `yolonas`. Both of these models are object detection models and are trained to detect the same set of labels [listed below](#available-label-types).

-Not all model types are supported by all detectors, so it's important to choose a model type to match your detector as shown in the table under [supported detector types](#supported-detector-types).
+Not all model types are supported by all detectors, so it's important to choose a model type to match your detector as shown in the table under [supported detector types](#supported-detector-types). You can test model types for compatibility and speed on your hardware by using the base models.

 | Model Type  | Description                                                                                                                                  |
 | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -36,19 +30,27 @@ Using Frigate+ models with `onnx` is only available with Frigate 0.15 and later.

 :::

-| Hardware                                                                                                                     | Recommended Detector Type | Recommended Model Type |
-| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------- | ---------------------- |
-| [CPU](/configuration/object_detectors.md#cpu-detector-not-recommended)                                                       | `cpu`                     | `mobiledet`            |
-| [Coral (all form factors)](/configuration/object_detectors.md#edge-tpu-detector)                                             | `edgetpu`                 | `mobiledet`            |
-| [Intel](/configuration/object_detectors.md#openvino-detector)                                                                | `openvino`                | `yolonas`              |
-| [NVidia GPU](https://deploy-preview-13787--frigate-docs.netlify.app/configuration/object_detectors#onnx)\*                   | `onnx`                    | `yolonas`              |
-| [AMD ROCm GPU](https://deploy-preview-13787--frigate-docs.netlify.app/configuration/object_detectors#amdrocm-gpu-detector)\* | `onnx`                    | `yolonas`              |
+| Hardware                                                                         | Recommended Detector Type | Recommended Model Type |
+| -------------------------------------------------------------------------------- | ------------------------- | ---------------------- |
+| [CPU](/configuration/object_detectors.md#cpu-detector-not-recommended)           | `cpu`                     | `mobiledet`            |
+| [Coral (all form factors)](/configuration/object_detectors.md#edge-tpu-detector) | `edgetpu`                 | `mobiledet`            |
+| [Intel](/configuration/object_detectors.md#openvino-detector)                    | `openvino`                | `yolonas`              |
+| [NVidia GPU](/configuration/object_detectors#onnx)\*                             | `onnx`                    | `yolonas`              |
+| [AMD ROCm GPU](/configuration/object_detectors#amdrocm-gpu-detector)\*           | `rocm`                    | `yolonas`              |

 _\* Requires Frigate 0.15_

+## Improving your model
+
+Some users may find that Frigate+ models result in more false positives initially, but by submitting true and false positives, the model will improve. With all the new images now being submitted by subscribers, future base models will improve as more and more examples are incorporated. Note that only images with at least one verified label will be used when training your model. Submitting an image from Frigate as a true or false positive will not verify the image. You still must verify the image in Frigate+ in order for it to be used in training.
+
+- **Submit both true positives and false positives**. This will help the model differentiate between what is and isn't correct. You should aim for a target of 80% true positive submissions and 20% false positives across all of your images. If you are experiencing false positives in a specific area, submitting true positives for any object type near that area in similar lighting conditions will help teach the model what that area looks like when no objects are present.
+- **Lower your thresholds a little in order to generate more false/true positives near the threshold value**. For example, if you have some false positives that are scoring at 68% and some true positives scoring at 72%, you can try lowering your threshold to 65% and submitting both true and false positives within that range. This will help the model learn and widen the gap between true and false positive scores.
+- **Submit diverse images**. For the best results, you should provide at least 100 verified images per camera. Keep in mind that varying conditions should be included. You will want images from cloudy days, sunny days, dawn, dusk, and night. As circumstances change, you may need to submit new examples to address new types of false positives. For example, the change from summer days to snowy winter days or other changes such as a new grill or patio furniture may require additional examples and training.
+
 ## Available label types

-Frigate+ models support a more relevant set of objects for security cameras. Currently, the following objects are supported:
+Frigate+ models support a more relevant set of objects for security cameras. The labels for annotation in Frigate+ are configurable by editing the camera in the Cameras section of Frigate+. Currently, the following objects are supported:

 - **People**: `person`, `face`
 - **Vehicles**: `car`, `motorcycle`, `bicycle`, `boat`, `license_plate`
@@ -58,6 +60,16 @@ Frigate+ models support a more relevant set of objects for security cameras. Cur

 Other object types available in the default Frigate model are not available. Additional object types will be added in future releases.

+### Candidate labels
+
+Candidate labels are also available for annotation. These labels don't have enough data to be included in the model yet, but using them will help add support sooner. You can enable these labels by editing the camera settings.
+
+Where possible, these labels are mapped to existing labels during training. For example, any `baby` labels are mapped to `person` until support for new labels is added.
+
+The candidate labels are: `baby`, `royal mail`, `canada post`, `bpost`, `skunk`, `badger`, `possum`, `rodent`, `kangaroo`, `chicken`, `groundhog`, `boar`, `hedgehog`, `school bus`, `tractor`, `golf cart`, `garbage truck`, `bus`, `sports ball`
+
+Candidate labels are not available for automatic suggestions.
+
 ### Label attributes

 Frigate has special handling for some labels when using Frigate+ models. `face`, `license_plate`, and delivery logos such as `amazon`, `ups`, and `fedex` are considered attribute labels which are not tracked like regular objects and do not generate review items directly. In addition, the `threshold` filter will have no effect on these labels. You should adjust the `min_score` and other filter values as needed.
@@ -46,6 +46,17 @@ Some users have reported that this older device runs an older kernel causing iss
 6. Open the control panel - info scree. The coral TPU will now be recognised as a USB Device - google inc
 7. Start the frigate container. Everything should work now!

+### QNAP NAS
+
+QNAP NAS devices, such as the TS-253A, may use connected Coral TPU devices if [QuMagie](https://www.qnap.com/en/software/qumagie) is installed along with its QNAP AI Core extension. If any of the features—`facial recognition`, `object recognition`, or `similar photo recognition`—are enabled, Container Station applications such as `Frigate` or `CodeProject.AI Server` will be unable to initialize the TPU device in use.
+To allow the Coral TPU device to be discovered, the you must either:
+
+1. [Disable the AI recognition features in QuMagie](https://docs.qnap.com/application/qumagie/2.x/en-us/configuring-qnap-ai-core-settings-FB13CE03.html),
+2. Remove the QNAP AI Core extension or
+3. Manually start the QNAP AI Core extension after Frigate has fully started (not recommended).
+
+It is also recommended to restart the NAS once the changes have been made.
+
 ## USB Coral Detection Appears to be Stuck

 The USB Coral can become stuck and need to be restarted, this can happen for a number of reasons depending on hardware and software setup. Some common reasons are:
@@ -55,10 +66,10 @@ The USB Coral can become stuck and need to be restarted, this can happen for a n

 ## PCIe Coral Not Detected

-The most common reason for the PCIe Coral not being detected is that the driver has not been installed. This process varies based on what OS and kernel that is being run. 
+The most common reason for the PCIe Coral not being detected is that the driver has not been installed. This process varies based on what OS and kernel that is being run.

 - In most cases [the Coral docs](https://coral.ai/docs/m2/get-started/#2-install-the-pcie-driver-and-edge-tpu-runtime) show how to install the driver for the PCIe based Coral.
- For Ubuntu 22.04+ https://github.com/jnicolson/gasket-builder can be used to build and install the latest version of the driver.
+- For some newer Linux distros (for example, Ubuntu 22.04+), https://github.com/jnicolson/gasket-builder can be used to build and install the latest version of the driver.

 ## Attempting to load TPU as pci & Fatal Python error: Illegal instruction

@@ -0,0 +1,13 @@
+---
+id: gpu
+title: Troubleshooting GPU
+---
+
+## OpenVINO
+
+### Can't get OPTIMIZATION_CAPABILITIES property as no supported devices found.
+
+Some users have reported issues using some Intel iGPUs with OpenVINO, where the GPU would not be detected. This error can be caused by various problems, so it is important to ensure the configuration is setup correctly. Some solutions users have noted:
+
+- In some cases users have noted that an HDMI dummy plug was necessary to be plugged into the motherboard's HDMI port.
+- When mixing an Intel iGPU with Nvidia GPU, the devices can be mixed up between `/dev/dri/renderD128` and `/dev/dri/renderD129` so it is important to confirm the correct device, or map the entire `/dev/dri` directory into the Frigate container.
@@ -1,19 +1,24 @@
-import type * as Preset from '@docusaurus/preset-classic';
-import * as path from 'node:path';
-import type { Config, PluginConfig } from '@docusaurus/types';
-import type * as OpenApiPlugin from 'docusaurus-plugin-openapi-docs';
+import type * as Preset from "@docusaurus/preset-classic";
+import * as path from "node:path";
+import type { Config, PluginConfig } from "@docusaurus/types";
+import type * as OpenApiPlugin from "docusaurus-plugin-openapi-docs";

 const config: Config = {
-  title: 'Frigate',
-  tagline: 'NVR With Realtime Object Detection for IP Cameras',
-  url: 'https://docs.frigate.video',
-  baseUrl: '/',
-  onBrokenLinks: 'throw',
-  onBrokenMarkdownLinks: 'warn',
-  favicon: 'img/favicon.ico',
-  organizationName: 'blakeblackshear',
-  projectName: 'frigate',
-  themes: ['@docusaurus/theme-mermaid', 'docusaurus-theme-openapi-docs'],
+  title: "Frigate",
+  tagline: "NVR With Realtime Object Detection for IP Cameras",
+  url: "https://docs.frigate.video",
+  baseUrl: "/",
+  onBrokenLinks: "throw",
+  onBrokenMarkdownLinks: "warn",
+  favicon: "img/favicon.ico",
+  organizationName: "blakeblackshear",
+  projectName: "frigate",
+  themes: [
+    "@docusaurus/theme-mermaid",
+    "docusaurus-theme-openapi-docs",
+    "@inkeep/docusaurus/chatButton",
+    "@inkeep/docusaurus/searchBar",
+  ],
  markdown: {
    mermaid: true,
  },
@@ -27,39 +32,79 @@ const config: Config = {
    },
  },
  themeConfig: {
-    algolia: {
-      appId: 'WIURGBNBPY',
-      apiKey: 'd02cc0a6a61178b25da550212925226b',
-      indexName: 'frigate',
+    announcementBar: {
+      id: 'frigate_plus',
+      content: `
+        <span style="margin-right: 8px; display: inline-block; animation: pulse 2s infinite;">🚀</span>
+        Get more relevant and accurate detections with Frigate+ models.
+        <a style="margin-left: 12px; padding: 3px 10px; background: #94d2bd; color: #001219; text-decoration: none; border-radius: 4px; font-weight: 500; " target="_blank" rel="noopener noreferrer" href="https://frigate.video/plus/">Learn more</a>
+        <span style="margin-left: 8px; display: inline-block; animation: pulse 2s infinite;">✨</span>
+        <style>
+          @keyframes pulse {
+            0%, 100% { transform: scale(1); }
+            50%       { transform: scale(1.1); }
+          }
+        </style>`,
+      backgroundColor: '#005f73',
+      textColor: '#e0fbfc',
+      isCloseable: false,
    },
    docs: {
      sidebar: {
        hideable: true,
      },
    },
+    inkeepConfig: {
+      baseSettings: {
+        apiKey: "b1a4c4d73c9b48aa5b3cdae6e4c81f0bb3d1134eeb5a7100",
+        integrationId: "cm6xmhn9h000gs601495fkkdx",
+        organizationId: "org_map2JQEOco8U1ZYY",
+        primaryBrandColor: "#010101",
+      },
+      aiChatSettings: {
+        chatSubjectName: "Frigate",
+        botAvatarSrcUrl: "https://frigate.video/images/favicon.png",
+        getHelpCallToActions: [
+          {
+            name: "GitHub",
+            url: "https://github.com/blakeblackshear/frigate",
+            icon: {
+              builtIn: "FaGithub",
+            },
+          },
+        ],
+        quickQuestions: [
+          "How to configure and setup camera settings?",
+          "How to setup notifications?",
+          "Supported builtin detectors?",
+          "How to restream video feed?",
+          "How can I get sound or audio in my recordings?",
+        ],
+      },
+    },
    prism: {
-      additionalLanguages: ['bash', 'json'],
+      additionalLanguages: ["bash", "json"],
    },
    languageTabs: [
      {
-        highlight: 'python',
-        language: 'python',
-        logoClass: 'python',
+        highlight: "python",
+        language: "python",
+        logoClass: "python",
      },
      {
-        highlight: 'javascript',
-        language: 'nodejs',
-        logoClass: 'nodejs',
+        highlight: "javascript",
+        language: "nodejs",
+        logoClass: "nodejs",
      },
      {
-        highlight: 'javascript',
-        language: 'javascript',
-        logoClass: 'javascript',
+        highlight: "javascript",
+        language: "javascript",
+        logoClass: "javascript",
      },
      {
-        highlight: 'bash',
-        language: 'curl',
-        logoClass: 'curl',
+        highlight: "bash",
+        language: "curl",
+        logoClass: "curl",
      },
      {
        highlight: "rust",
@@ -68,28 +113,28 @@ const config: Config = {
      },
    ],
    navbar: {
-      title: 'Frigate',
+      title: "Frigate",
      logo: {
-        alt: 'Frigate',
-        src: 'img/logo.svg',
-        srcDark: 'img/logo-dark.svg',
+        alt: "Frigate",
+        src: "img/logo.svg",
+        srcDark: "img/logo-dark.svg",
      },
      items: [
        {
-          to: '/',
-          activeBasePath: 'docs',
-          label: 'Docs',
-          position: 'left',
+          to: "/",
+          activeBasePath: "docs",
+          label: "Docs",
+          position: "left",
        },
        {
-          href: 'https://frigate.video',
-          label: 'Website',
-          position: 'right',
+          href: "https://frigate.video",
+          label: "Website",
+          position: "right",
        },
        {
-          href: 'http://demo.frigate.video',
-          label: 'Demo',
-          position: 'right',
+          href: "http://demo.frigate.video",
+          label: "Demo",
+          position: "right",
        },
        {
          type: 'localeDropdown',
@@ -109,18 +154,18 @@ const config: Config = {
      ],
    },
    footer: {
-      style: 'dark',
+      style: "dark",
      links: [
        {
-          title: 'Community',
+          title: "Community",
          items: [
            {
-              label: 'GitHub',
-              href: 'https://github.com/blakeblackshear/frigate',
+              label: "GitHub",
+              href: "https://github.com/blakeblackshear/frigate",
            },
            {
-              label: 'Discussions',
-              href: 'https://github.com/blakeblackshear/frigate/discussions',
+              label: "Discussions",
+              href: "https://github.com/blakeblackshear/frigate/discussions",
            },
          ],
        },
@@ -129,19 +174,19 @@ const config: Config = {
    },
  },
  plugins: [
-    path.resolve(__dirname, 'plugins', 'raw-loader'),
+    path.resolve(__dirname, "plugins", "raw-loader"),
    [
-      'docusaurus-plugin-openapi-docs',
+      "docusaurus-plugin-openapi-docs",
      {
-        id: 'openapi',
-        docsPluginId: 'classic', // configured for preset-classic
+        id: "openapi",
+        docsPluginId: "classic", // configured for preset-classic
        config: {
          frigateApi: {
-            specPath: 'static/frigate-api.yaml',
-            outputDir: 'docs/integrations/api',
+            specPath: "static/frigate-api.yaml",
+            outputDir: "docs/integrations/api",
            sidebarOptions: {
-              groupPathsBy: 'tag',
-              categoryLinkSource: 'tag',
+              groupPathsBy: "tag",
+              categoryLinkSource: "tag",
              sidebarCollapsible: true,
              sidebarCollapsed: true,
            },
@@ -149,23 +194,24 @@ const config: Config = {
          } satisfies OpenApiPlugin.Options,
        },
      },
-    ]
+    ],
  ] as PluginConfig[],
  presets: [
    [
-      'classic',
+      "classic",
      {
        docs: {
-          routeBasePath: '/',
-          sidebarPath: './sidebars.ts',
+          routeBasePath: "/",
+          sidebarPath: "./sidebars.ts",
          // Please change this to your repo.
-          editUrl: 'https://github.com/blakeblackshear/frigate/edit/master/docs/',
+          editUrl:
+            "https://github.com/blakeblackshear/frigate/edit/master/docs/",
          sidebarCollapsible: false,
-          docItemComponent: '@theme/ApiItem', // Derived from docusaurus-theme-openapi
+          docItemComponent: "@theme/ApiItem", // Derived from docusaurus-theme-openapi
        },

        theme: {
-          customCss: './src/css/custom.css',
+          customCss: "./src/css/custom.css",
        },
      } satisfies Preset.Options,
    ],
@@ -12,6 +12,7 @@
        "@docusaurus/plugin-content-docs": "^3.6.3",
        "@docusaurus/preset-classic": "^3.7.0",
        "@docusaurus/theme-mermaid": "^3.6.3",
+        "@inkeep/docusaurus": "^2.0.16",
        "@mdx-js/react": "^3.1.0",
        "clsx": "^2.1.1",
        "docusaurus-plugin-openapi-docs": "^4.3.1",
@@ -3954,6 +3955,12 @@
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
+    "node_modules/@inkeep/docusaurus": {
+      "version": "2.0.16",
+      "resolved": "https://registry.npmjs.org/@inkeep/docusaurus/-/docusaurus-2.0.16.tgz",
+      "integrity": "sha512-dQhjlvFnl3CVr0gWeJ/V/qLnDy1XYrCfkdVSa2D3gJTxI9/vOf9639Y1aPxTxO88DiXuW9CertLrZLB6SoJ2yg==",
+      "license": "MIT"
+    },
    "node_modules/@isaacs/cliui": {
      "version": "8.0.2",
      "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
@@ -21,6 +21,7 @@
    "@docusaurus/plugin-content-docs": "^3.6.3",
    "@docusaurus/preset-classic": "^3.7.0",
    "@docusaurus/theme-mermaid": "^3.6.3",
+    "@inkeep/docusaurus": "^2.0.16",
    "@mdx-js/react": "^3.1.0",
    "clsx": "^2.1.1",
    "docusaurus-plugin-openapi-docs": "^4.3.1",
@@ -5,12 +5,13 @@ import frigateHttpApiSidebar from "./docs/integrations/api/sidebar";
 const sidebars: SidebarsConfig = {
  docs: {
    Frigate: [
-      "frigate/index",
-      "frigate/hardware",
-      "frigate/installation",
-      "frigate/camera_setup",
-      "frigate/video_pipeline",
-      "frigate/glossary",
+      'frigate/index',
+      'frigate/hardware',
+      'frigate/installation',
+      'frigate/updating',
+      'frigate/camera_setup',
+      'frigate/video_pipeline',
+      'frigate/glossary',
    ],
    Guides: [
      "guides/getting_started",
@@ -91,15 +92,16 @@ const sidebars: SidebarsConfig = {
      "configuration/metrics",
      "integrations/third_party_extensions",
    ],
-    "Frigate+": [
-      "plus/index",
-      "plus/first_model",
-      "plus/improving_model",
-      "plus/faq",
+    'Frigate+': [
+      'plus/index',
+      'plus/annotating',
+      'plus/first_model',
+      'plus/faq',
    ],
    Troubleshooting: [
      "troubleshooting/faqs",
      "troubleshooting/recordings",
+      "troubleshooting/gpu",
      "troubleshooting/edgetpu",
    ],
    Development: [
@@ -33,6 +33,7 @@ from frigate.models import User
 logger = logging.getLogger(__name__)

 router = APIRouter(tags=[Tags.auth])
+VALID_ROLES = ["admin", "viewer"]


 class RateLimiter:
@@ -272,12 +273,13 @@ def auth(request: Request):
            else proxy_config.default_role
        )

-        # if comma-separated with "admin", use "admin", else use default role
-        success_response.headers["remote-role"] = (
-            "admin"
-            if role
-            and "admin" in [r.strip() for r in role.split(proxy_config.separator)]
-            else proxy_config.default_role
+        # if comma-separated with "admin", use "admin",
+        # if comma-separated with "viewer", use "viewer",
+        # else use default role
+
+        roles = [r.strip() for r in role.split(proxy_config.separator)] if role else []
+        success_response.headers["remote-role"] = next(
+            (r for r in VALID_ROLES if r in roles), proxy_config.default_role
        )

        return success_response
@@ -402,7 +404,7 @@ def login(request: Request, body: AppPostLoginBody):
    password_hash = db_user.password_hash
    if verify_password(password, password_hash):
        role = getattr(db_user, "role", "viewer")
-        if role not in ["admin", "viewer"]:
+        if role not in VALID_ROLES:
            role = "viewer"  # Enforce valid roles
        expiration = int(time.time()) + JWT_SESSION_LENGTH
        encoded_jwt = create_encoded_jwt(user, role, expiration, request.app.jwt_token)
@@ -432,7 +434,7 @@ def create_user(
    if not re.match("^[A-Za-z0-9._]+$", body.username):
        return JSONResponse(content={"message": "Invalid username"}, status_code=400)

-    role = body.role if body.role in ["admin", "viewer"] else "viewer"
+    role = body.role if body.role in VALID_ROLES else "viewer"
    password_hash = hash_password(body.password, iterations=HASH_ITERATIONS)
    User.insert(
        {
@@ -503,7 +505,7 @@ async def update_role(
        return JSONResponse(
            content={"message": "Cannot modify admin user's role"}, status_code=403
        )
-    if body.role not in ["admin", "viewer"]:
+    if body.role not in VALID_ROLES:
        return JSONResponse(
            content={"message": "Role must be 'admin' or 'viewer'"}, status_code=400
        )
@@ -154,7 +154,25 @@ def train_face(request: Request, name: str, body: dict = None):
        x2 = x1 + int(face_box[2] * detect_config.width) - 4
        y2 = y1 + int(face_box[3] * detect_config.height) - 4
        face = snapshot[y1:y2, x1:x2]
-        cv2.imwrite(os.path.join(new_file_folder, new_name), face)
+        success = True
+
+        if face.size > 0:
+            try:
+                cv2.imwrite(os.path.join(new_file_folder, new_name), face)
+                success = True
+            except Exception:
+                pass
+
+        if not success:
+            return JSONResponse(
+                content=(
+                    {
+                        "success": False,
+                        "message": "Invalid face box or no face exists",
+                    }
+                ),
+                status_code=404,
+            )

    context: EmbeddingsContext = request.app.embeddings
    context.clear_face_classifier()
@@ -598,7 +598,7 @@ def recording_clip(
            if clip.start_time < start_ts:
                file.write(f"inpoint {int(start_ts - clip.start_time)}\n")

-            # if this is the ending clip and end trim is enabled, add an outpoint
+            # if this is the ending clip, add an outpoint
            if clip.end_time > end_ts:
                file.write(f"outpoint {int(end_ts - clip.start_time)}\n")

@@ -58,9 +58,8 @@ async def review(
    )

    clauses = [
-        (ReviewSegment.start_time > after)
-        & (ReviewSegment.start_time < before)
-        & ((ReviewSegment.end_time.is_null(True)) | (ReviewSegment.end_time < before))
+        (ReviewSegment.start_time < before)
+        & ((ReviewSegment.end_time.is_null(True)) | (ReviewSegment.end_time > after))
    ]

    if cameras != "all":
@@ -73,6 +73,7 @@ from frigate.track.object_processing import TrackedObjectProcessor
 from frigate.util.builtin import empty_and_close_queue
 from frigate.util.image import SharedMemoryFrameManager, UntrackedSharedMemory
 from frigate.util.object import get_camera_regions_grid
+from frigate.util.services import set_file_limit
 from frigate.version import VERSION
 from frigate.video import capture_camera, track_camera
 from frigate.watchdog import FrigateWatchdog
@@ -632,6 +633,9 @@ class FrigateApp:
        # Ensure global state.
        self.ensure_dirs()

+        # Set soft file limits.
+        set_file_limit()
+
        # Start frigate services.
        self.init_camera_metrics()
        self.init_queues()
@@ -256,6 +256,7 @@ class CameraState:
        updated_ids = current_ids.intersection(previous_ids)

        for id in new_ids:
+            logger.debug(f"{self.name}: New tracked object ID: {id}")
            new_obj = tracked_objects[id] = TrackedObject(
                self.config.model,
                self.camera_config,
@@ -265,7 +266,13 @@ class CameraState:
            )

            # add initial frame to frame cache
-            self.frame_cache[frame_time] = np.copy(current_frame)
+            logger.debug(
+                f"{self.name}: New object, adding {frame_time} to frame cache for {id}"
+            )
+            self.frame_cache[frame_time] = {
+                "frame": np.copy(current_frame),
+                "object_id": id,
+            }

            # save initial thumbnail data and best object
            thumbnail_data = {
@@ -284,11 +291,9 @@ class CameraState:
            new_obj.thumbnail_data = thumbnail_data
            tracked_objects[id].thumbnail_data = thumbnail_data
            object_type = new_obj.obj_data["label"]
-            self.best_objects[object_type] = new_obj

            # call event handlers
-            for c in self.callbacks["snapshot"]:
-                c(self.name, self.best_objects[object_type], frame_name)
+            self.send_mqtt_snapshot(new_obj, object_type)

            for c in self.callbacks["start"]:
                c(self.name, new_obj, frame_name)
@@ -311,7 +316,13 @@ class CameraState:
                    updated_obj.thumbnail_data["frame_time"] == frame_time
                    and frame_time not in self.frame_cache
                ):
-                    self.frame_cache[frame_time] = np.copy(current_frame)
+                    logger.debug(
+                        f"{self.name}: Existing object, adding {frame_time} to frame cache for {id}"
+                    )
+                    self.frame_cache[frame_time] = {
+                        "frame": np.copy(current_frame),
+                        "object_id": id,
+                    }

                updated_obj.last_updated = frame_time

@@ -337,6 +348,7 @@ class CameraState:
            removed_obj = tracked_objects[id]
            if "end_time" not in removed_obj.obj_data:
                removed_obj.obj_data["end_time"] = frame_time
+                logger.debug(f"{self.name}: end callback for object {id}")
                for c in self.callbacks["end"]:
                    c(self.name, removed_obj, frame_name)

@@ -403,13 +415,9 @@ class CameraState:
                    or (now - current_best.thumbnail_data["frame_time"])
                    > self.camera_config.best_image_timeout
                ):
-                    self.best_objects[object_type] = obj
-                    for c in self.callbacks["snapshot"]:
-                        c(self.name, self.best_objects[object_type], frame_name)
+                    self.send_mqtt_snapshot(obj, object_type)
            else:
-                self.best_objects[object_type] = obj
-                for c in self.callbacks["snapshot"]:
-                    c(self.name, self.best_objects[object_type], frame_name)
+                self.send_mqtt_snapshot(obj, object_type)

        for c in self.callbacks["camera_activity"]:
            c(self.name, camera_activity)
@@ -418,7 +426,7 @@ class CameraState:
        current_thumb_frames = {
            obj.thumbnail_data["frame_time"]
            for obj in tracked_objects.values()
-            if not obj.false_positive and obj.thumbnail_data is not None
+            if obj.thumbnail_data is not None
        }
        current_best_frames = {
            obj.thumbnail_data["frame_time"] for obj in self.best_objects.values()
@@ -428,7 +436,20 @@ class CameraState:
            for t in self.frame_cache.keys()
            if t not in current_thumb_frames and t not in current_best_frames
        ]
+        if len(thumb_frames_to_delete) > 0:
+            logger.debug(f"{self.name}: Current frame cache contents:")
+            for k, v in self.frame_cache.items():
+                logger.debug(f"  frame time: {k}, object id: {v['object_id']}")
+            for obj_id, obj in tracked_objects.items():
+                thumb_time = (
+                    obj.thumbnail_data["frame_time"] if obj.thumbnail_data else None
+                )
+                logger.debug(
+                    f"{self.name}: Tracked object {obj_id} thumbnail frame_time: {thumb_time}, false positive: {obj.false_positive}"
+                )
        for t in thumb_frames_to_delete:
+            object_id = self.frame_cache[t].get("object_id", "unknown")
+            logger.debug(f"{self.name}: Deleting {t} from frame cache for {object_id}")
            del self.frame_cache[t]

        with self.current_frame_lock:
@@ -445,6 +466,20 @@ class CameraState:

            self.previous_frame_id = frame_name

+    def send_mqtt_snapshot(self, new_obj: TrackedObject, object_type: str) -> None:
+        for c in self.callbacks["snapshot"]:
+            updated = c(self.name, new_obj)
+
+            # if the snapshot was not updated, then this object is not a best object
+            # but all new objects should be considered the next best object
+            # so we remove the label from the best objects
+            if updated:
+                self.best_objects[object_type] = new_obj
+            else:
+                if object_type in self.best_objects:
+                    self.best_objects.pop(object_type)
+                break
+
    def save_manual_event_image(
        self,
        frame: np.ndarray | None,
@@ -84,7 +84,7 @@ class FaceRecognitionConfig(FrigateBaseModel):
        default=1,
        gt=0,
        le=6,
-        title="Min face attempts for the sub label to be applied to the person object.",
+        title="Min face recognitions for the sub label to be applied to the person object.",
    )
    save_attempts: int = Field(
        default=100, ge=0, title="Number of face attempts to save in the train tab."
@@ -108,21 +108,24 @@ class FaceRecognizer(ABC):
            image, M, (output_width, output_height), flags=cv2.INTER_CUBIC
        )

-    def get_blur_factor(self, input: np.ndarray) -> float:
-        """Calculates the factor for the confidence based on the blur of the image."""
+    def get_blur_confidence_reduction(self, input: np.ndarray) -> float:
+        """Calculates the reduction in confidence based on the blur of the image."""
        if not self.config.face_recognition.blur_confidence_filter:
-            return 1.0
+            return 0.0

        variance = cv2.Laplacian(input, cv2.CV_64F).var()
+        logger.debug(f"face detected with blurriness {variance}")

-        if variance < 60:  # image is very blurry
-            return 0.96
-        elif variance < 70:  # image moderately blurry
-            return 0.98
-        elif variance < 80:  # image is slightly blurry
-            return 0.99
+        if variance < 120:  # image is very blurry
+            return 0.06
+        elif variance < 160:  # image moderately blurry
+            return 0.04
+        elif variance < 200:  # image is slightly blurry
+            return 0.02
+        elif variance < 250:  # image is mostly clear
+            return 0.01
        else:
-            return 1.0
+            return 0.0


 def similarity_to_confidence(
@@ -234,8 +237,7 @@ class FaceNetRecognizer(FaceRecognizer):
        # face recognition is best run on grayscale images

        # get blur factor before aligning face
-        blur_factor = self.get_blur_factor(face_image)
-        logger.debug(f"face detected with blurriness {blur_factor}")
+        blur_reduction = self.get_blur_confidence_reduction(face_image)

        # align face and run recognition
        img = self.align_face(face_image, face_image.shape[1], face_image.shape[0])
@@ -258,7 +260,7 @@ class FaceNetRecognizer(FaceRecognizer):
                score = confidence
                label = name

-        return label, round(score * blur_factor, 2)
+        return label, round(score - blur_reduction, 2)


 class ArcFaceRecognizer(FaceRecognizer):
@@ -344,9 +346,8 @@ class ArcFaceRecognizer(FaceRecognizer):

        # face recognition is best run on grayscale images

-        # get blur factor before aligning face
-        blur_factor = self.get_blur_factor(face_image)
-        logger.debug(f"face detected with blurriness {blur_factor}")
+        # get blur reduction before aligning face
+        blur_reduction = self.get_blur_confidence_reduction(face_image)

        # align face and run recognition
        img = self.align_face(face_image, face_image.shape[1], face_image.shape[0])
@@ -367,4 +368,4 @@ class ArcFaceRecognizer(FaceRecognizer):
                score = confidence
                label = name

-        return label, round(score * blur_factor, 2)
+        return label, round(score - blur_reduction, 2)
@@ -167,6 +167,8 @@ class LicensePlateProcessingMixin:
            outputs = self.model_runner.recognition_model(norm_images)
        except Exception as e:
            logger.warning(f"Error running LPR recognition model: {e}")
+            return [], []
+
        return self.ctc_decoder(outputs)

    def _process_license_plate(
@@ -1498,18 +1500,24 @@ class LicensePlateProcessingMixin:

        # Determine subLabel based on known plates, use regex matching
        # Default to the detected plate, use label name if there's a match
-        sub_label = next(
-            (
-                label
-                for label, plates in self.lpr_config.known_plates.items()
-                if any(
-                    re.match(f"^{plate}$", top_plate)
-                    or distance(plate, top_plate) <= self.lpr_config.match_distance
-                    for plate in plates
-                )
-            ),
-            None,
-        )
+        try:
+            sub_label = next(
+                (
+                    label
+                    for label, plates in self.lpr_config.known_plates.items()
+                    if any(
+                        re.match(f"^{plate}$", top_plate)
+                        or distance(plate, top_plate) <= self.lpr_config.match_distance
+                        for plate in plates
+                    )
+                ),
+                None,
+            )
+        except re.error:
+            logger.error(
+                f"{camera}: Invalid regex in known plates configuration: {self.lpr_config.known_plates}"
+            )
+            sub_label = None

        # If it's a known plate, publish to sub_label
        if sub_label is not None:
@@ -1577,19 +1585,6 @@ class LicensePlateProcessingMixin:
            if object_id in self.camera_current_cars.get(camera, []):
                self.camera_current_cars[camera].remove(object_id)

-                if len(self.camera_current_cars[camera]) == 0:
-                    self.requestor.send_data(
-                        "tracked_object_update",
-                        json.dumps(
-                            {
-                                "type": TrackedObjectUpdateTypesEnum.lpr,
-                                "name": None,
-                                "plate": None,
-                                "camera": camera,
-                            }
-                        ),
-                    )
-

 class CTCDecoder:
    """
@@ -109,7 +109,13 @@ class BirdRealTimeProcessor(RealTimeProcessorApi):
            obj_data["box"][1],
            obj_data["box"][2],
            obj_data["box"][3],
-            224,
+            int(
+                max(
+                    obj_data["box"][1] - obj_data["box"][0],
+                    obj_data["box"][3] - obj_data["box"][2],
+                )
+                * 1.1
+            ),
            1.0,
        )

@@ -6,6 +6,7 @@ import json
 import logging
 import os
 import shutil
+from pathlib import Path
 from typing import Any, Optional

 import cv2
@@ -302,9 +303,6 @@ class FaceRealTimeProcessor(RealTimeProcessorApi):
            self.person_face_history[id]
        )

-        if len(self.person_face_history[id]) < self.face_config.min_faces:
-            weighted_sub_label = "unknown"
-
        self.requestor.send_data(
            "tracked_object_update",
            json.dumps(
@@ -443,18 +441,6 @@ class FaceRealTimeProcessor(RealTimeProcessorApi):
            if object_id in self.camera_current_people.get(camera, []):
                self.camera_current_people[camera].remove(object_id)

-                if len(self.camera_current_people[camera]) == 0:
-                    self.requestor.send_data(
-                        "tracked_object_update",
-                        json.dumps(
-                            {
-                                "type": TrackedObjectUpdateTypesEnum.face,
-                                "name": None,
-                                "camera": camera,
-                            }
-                        ),
-                    )
-
    def weighted_average(
        self, results_list: list[tuple[str, float, int]], max_weight: int = 4000
    ):
@@ -500,6 +486,10 @@ class FaceRealTimeProcessor(RealTimeProcessorApi):

        best_name = max(weighted_scores, key=weighted_scores.get)

+        # If the number of faces for this person < min_faces, we are not confident it is a correct result
+        if counts[best_name] < self.face_config.min_faces:
+            return None, 0.0
+
        # If the best name has the same number of results as another name, we are not confident it is a correct result
        for name, count in counts.items():
            if name != best_name and counts[best_name] == count:
@@ -538,4 +528,4 @@ class FaceRealTimeProcessor(RealTimeProcessorApi):

            # delete oldest face image if maximum is reached
            if len(files) > self.config.face_recognition.save_attempts:
-                os.unlink(os.path.join(folder, files[-1]))
+                Path(os.path.join(folder, files[-1])).unlink(missing_ok=True)
@@ -59,7 +59,6 @@ class OvDetector(DetectionApi):
            )
            self.model_invalid = True

-        # Ensure the SSD model has the right input and output shapes
        if self.ov_model_type == ModelTypeEnum.ssd:
            model_inputs = self.interpreter.inputs
            model_outputs = self.interpreter.outputs
@@ -75,12 +74,6 @@ class OvDetector(DetectionApi):
                )
                self.model_invalid = True

-            if model_inputs[0].get_shape() != ov.Shape([1, self.w, self.h, 3]):
-                logger.error(
-                    f"SSD model input doesn't match. Found {model_inputs[0].get_shape()}."
-                )
-                self.model_invalid = True
-
            output_shape = model_outputs[0].get_shape()
            if output_shape[0] != 1 or output_shape[1] != 1 or output_shape[3] != 7:
                logger.error(f"SSD model output doesn't match. Found {output_shape}.")
@@ -100,13 +93,6 @@ class OvDetector(DetectionApi):
                    f"YoloNAS models must be exported in flat format and only have 1 output. Found {len(model_outputs)}."
                )
                self.model_invalid = True
-
-            if model_inputs[0].get_shape() != ov.Shape([1, 3, self.w, self.h]):
-                logger.error(
-                    f"YoloNAS model input doesn't match. Found {model_inputs[0].get_shape()}, but expected {[1, 3, self.w, self.h]}."
-                )
-                self.model_invalid = True
-
            output_shape = model_outputs[0].partial_shape
            if output_shape[-1] != 7:
                logger.error(
@@ -1,5 +1,6 @@
 import ctypes
 import logging
+import platform

 import numpy as np

@@ -219,6 +220,14 @@ class TensorRtDetector(DetectionApi):
        ]

    def __init__(self, detector_config: TensorRTDetectorConfig):
+        if platform.machine() == "x86_64":
+            logger.error(
+                "TensorRT detector is no longer supported on amd64 system. Please use ONNX detector instead, see https://docs.frigate.video/configuration/object_detectors#onnx for more information."
+            )
+            raise ImportError(
+                "TensorRT detector is no longer supported on amd64 system. Please use ONNX detector instead, see https://docs.frigate.video/configuration/object_detectors#onnx for more information."
+            )
+
        assert TRT_SUPPORT, (
            f"TensorRT libraries not found, {DETECTOR_KEY} detector not present"
        )
@@ -1,12 +1,14 @@
 """SQLite-vec embeddings database."""

 import datetime
+import io
 import logging
 import os
 import threading
 import time

 from numpy import ndarray
+from PIL import Image
 from playhouse.shortcuts import model_to_dict

 from frigate.comms.inter_process import InterProcessRequestor
@@ -199,14 +201,31 @@ class Embeddings:
        @param: upsert If embedding should be upserted into vec DB
        """
        start = datetime.datetime.now().timestamp()
-        ids = list(event_thumbs.keys())
-        embeddings = self.vision_embedding(list(event_thumbs.values()))
+        valid_ids = []
+        valid_thumbs = []
+        for eid, thumb in event_thumbs.items():
+            try:
+                img = Image.open(io.BytesIO(thumb))
+                img.verify()  # Will raise if corrupt
+                valid_ids.append(eid)
+                valid_thumbs.append(thumb)
+            except Exception as e:
+                logger.warning(
+                    f"Embeddings reindexing: Skipping corrupt thumbnail for event {eid}: {e}"
+                )
+
+        if not valid_thumbs:
+            logger.warning(
+                "Embeddings reindexing: No valid thumbnails to embed in this batch."
+            )
+            return []
+
+        embeddings = self.vision_embedding(valid_thumbs)

        if upsert:
            items = []
-
-            for i in range(len(ids)):
-                items.append(ids[i])
+            for i in range(len(valid_ids)):
+                items.append(valid_ids[i])
                items.append(serialize(embeddings[i]))
                self.image_eps.update()

@@ -214,12 +233,12 @@ class Embeddings:
                """
                INSERT OR REPLACE INTO vec_thumbnails(id, thumbnail_embedding)
                VALUES {}
-                """.format(", ".join(["(?, ?)"] * len(ids))),
+                """.format(", ".join(["(?, ?)"] * len(valid_ids))),
                items,
            )

        duration = datetime.datetime.now().timestamp() - start
-        self.text_inference_speed.update(duration / len(ids))
+        self.text_inference_speed.update(duration / len(valid_ids))

        return embeddings

@@ -491,6 +491,6 @@ def parse_preset_output_record(arg: Any, force_record_hvc1: bool) -> list[str]:

    if force_record_hvc1:
        # Apple only supports HEVC if it is hvc1 (vs. hev1)
-        preset += FFMPEG_HVC1_ARGS
+        return preset + FFMPEG_HVC1_ARGS

    return preset
@@ -265,9 +265,15 @@ class OnvifController:
                            "RelativeZoomTranslationSpace"
                        ][zoom_space_id]["URI"]
                else:
-                    if "Zoom" in move_request["Translation"]:
+                    if (
+                        move_request["Translation"] is not None
+                        and "Zoom" in move_request["Translation"]
+                    ):
                        del move_request["Translation"]["Zoom"]
-                    if "Zoom" in move_request["Speed"]:
+                    if (
+                        move_request["Speed"] is not None
+                        and "Zoom" in move_request["Speed"]
+                    ):
                        del move_request["Speed"]["Zoom"]
                    logger.debug(
                        f"{camera_name}: Relative move request after deleting zoom: {move_request}"
@@ -792,6 +798,10 @@ class OnvifController:
            )
            return

+        logger.debug(
+            f"{camera_name}: Pan/tilt status: {pan_tilt_status}, Zoom status: {zoom_status}"
+        )
+
        if pan_tilt_status == "IDLE" and (zoom_status is None or zoom_status == "IDLE"):
            self.cams[camera_name]["active"] = False
            if not self.ptz_metrics[camera_name].motor_stopped.is_set():
@@ -126,7 +126,7 @@ class RecordingExporter(threading.Thread):
            minutes = int(diff / 60)
            seconds = int(diff % 60)
            ffmpeg_cmd = [
-                self.config.ffmpeg.ffmpeg_path,
+                "/usr/lib/ffmpeg/7.0/bin/ffmpeg",  # hardcode path for exports thumbnail due to missing libwebp support
                "-hide_banner",
                "-loglevel",
                "warning",
@@ -48,8 +48,9 @@ class TestHttpReview(BaseTestHttp):
    ###################################  GET /review Endpoint   ########################################################
    ####################################################################################################################

-    # Does not return any data point since the end time (before parameter) is not passed and the review segment end_time is 2 seconds from now
-    def test_get_review_no_filters_no_matches(self):
+    def test_get_review_that_overlaps_default_period(self):
+        """Test that a review item that starts during the default period
+        but ends after is included in the results."""
        now = datetime.now().timestamp()

        with TestClient(self.app) as client:
@@ -57,7 +58,7 @@ class TestHttpReview(BaseTestHttp):
            response = client.get("/review")
            assert response.status_code == 200
            response_json = response.json()
-            assert len(response_json) == 0
+            assert len(response_json) == 1

    def test_get_review_no_filters(self):
        now = datetime.now().timestamp()
@@ -73,11 +74,13 @@ class TestHttpReview(BaseTestHttp):
            assert response_json[0]["has_been_reviewed"] == False

    def test_get_review_with_time_filter_no_matches(self):
+        """Test that review items outside the range are not returned."""
        now = datetime.now().timestamp()

        with TestClient(self.app) as client:
            id = "123456.random"
-            super().insert_mock_review_segment(id, now, now + 2)
+            super().insert_mock_review_segment(id, now - 2, now - 1)
+            super().insert_mock_review_segment(f"{id}2", now + 4, now + 5)
            params = {
                "after": now,
                "before": now + 3,
@@ -11,7 +11,7 @@ from typing import Any

 import cv2
 import numpy as np
-from peewee import DoesNotExist
+from peewee import SQL, DoesNotExist

 from frigate.camera.state import CameraState
 from frigate.comms.config_updater import ConfigSubscriber
@@ -29,9 +29,13 @@ from frigate.config import (
    RecordConfig,
    SnapshotsConfig,
 )
-from frigate.const import FAST_QUEUE_TIMEOUT, UPDATE_CAMERA_ACTIVITY
+from frigate.const import (
+    FAST_QUEUE_TIMEOUT,
+    UPDATE_CAMERA_ACTIVITY,
+    UPSERT_REVIEW_SEGMENT,
+)
 from frigate.events.types import EventStateEnum, EventTypeEnum
-from frigate.models import Event, Timeline
+from frigate.models import Event, ReviewSegment, Timeline
 from frigate.track.tracked_object import TrackedObject
 from frigate.util.image import SharedMemoryFrameManager

@@ -152,7 +156,7 @@ class TrackedObjectProcessor(threading.Thread):
                )
            )

-        def snapshot(camera, obj: TrackedObject, frame_name: str):
+        def snapshot(camera: str, obj: TrackedObject) -> bool:
            mqtt_config: CameraMqttConfig = self.config.cameras[camera].mqtt
            if mqtt_config.enabled and self.should_mqtt_snapshot(camera, obj):
                jpg_bytes = obj.get_img_bytes(
@@ -185,6 +189,10 @@ class TrackedObjectProcessor(threading.Thread):
                                retain=True,
                            )

+                    return True
+
+            return False
+
        def camera_activity(camera, activity):
            last_activity = self.camera_activity.get(camera)

@@ -357,6 +365,60 @@ class TrackedObjectProcessor(threading.Thread):
                data=Timeline.data.update({"sub_label": (sub_label, score)})
            ).where(Timeline.source_id == event_id).execute()

+            # only update ended review segments
+            # manually updating a sub_label from the UI is only possible for ended tracked objects
+            try:
+                review_segment = ReviewSegment.get(
+                    (
+                        SQL(
+                            "json_extract(data, '$.detections') LIKE ?",
+                            [f'%"{event_id}"%'],
+                        )
+                    )
+                    & (ReviewSegment.end_time.is_null(False))
+                )
+
+                segment_data = review_segment.data
+                detection_ids = segment_data.get("detections", [])
+
+                # Rebuild objects list and sync sub_labels
+                objects_list = []
+                sub_labels = set()
+                events = Event.select(Event.id, Event.label, Event.sub_label).where(
+                    Event.id.in_(detection_ids)
+                )
+                for det_event in events:
+                    if det_event.sub_label:
+                        sub_labels.add(det_event.sub_label)
+                        objects_list.append(
+                            f"{det_event.label}-verified"
+                        )  # eg, "bird-verified"
+                    else:
+                        objects_list.append(det_event.label)  # eg, "bird"
+
+                segment_data["sub_labels"] = list(sub_labels)
+                segment_data["objects"] = objects_list
+
+                updated_data = {
+                    ReviewSegment.id.name: review_segment.id,
+                    ReviewSegment.camera.name: review_segment.camera,
+                    ReviewSegment.start_time.name: review_segment.start_time,
+                    ReviewSegment.end_time.name: review_segment.end_time,
+                    ReviewSegment.severity.name: review_segment.severity,
+                    ReviewSegment.thumb_path.name: review_segment.thumb_path,
+                    ReviewSegment.data.name: segment_data,
+                }
+
+                self.requestor.send_data(UPSERT_REVIEW_SEGMENT, updated_data)
+                logger.debug(
+                    f"Updated sub_label for event {event_id} in review segment {review_segment.id}"
+                )
+
+            except ReviewSegment.DoesNotExist:
+                logger.debug(
+                    f"No review segment found with event ID {event_id} when updating sub_label"
+                )
+
        return True

    def set_recognized_license_plate(
@@ -350,6 +350,9 @@ class TrackedObject:

        self.obj_data.update(obj_data)
        self.current_zones = current_zones
+        logger.debug(
+            f"{self.camera_config.name}: Updating {obj_data['id']}: thumb update? {thumb_update}, significant change? {significant_change}, path update? {path_update}, autotracker update? {autotracker_update} "
+        )
        return (thumb_update, significant_change, path_update, autotracker_update)

    def to_dict(self):
@@ -416,7 +419,7 @@ class TrackedObject:

        try:
            best_frame = cv2.cvtColor(
-                self.frame_cache[self.thumbnail_data["frame_time"]],
+                self.frame_cache[self.thumbnail_data["frame_time"]]["frame"],
                cv2.COLOR_YUV2BGR_I420,
            )
        except KeyError:
@@ -445,7 +448,7 @@ class TrackedObject:

        try:
            best_frame = cv2.cvtColor(
-                self.frame_cache[self.thumbnail_data["frame_time"]],
+                self.frame_cache[self.thumbnail_data["frame_time"]]["frame"],
                cv2.COLOR_YUV2BGR_I420,
            )
        except KeyError:
@@ -345,6 +345,13 @@ def get_ort_providers(
                    "device_type": device,
                }
            )
+        elif provider == "MIGraphXExecutionProvider":
+            # MIGraphX uses more CPU than ROCM, while also being the same speed
+            if device == "MIGraphX":
+                providers.append(provider)
+                options.append({})
+            else:
+                continue
        elif provider == "CPUExecutionProvider":
            providers.append(provider)
            options.append(
@@ -5,6 +5,7 @@ import json
 import logging
 import os
 import re
+import resource
 import signal
 import subprocess as sp
 import traceback
@@ -306,11 +307,14 @@ def get_intel_gpu_stats(sriov: bool) -> Optional[dict[str, str]]:
    if sriov:
        intel_gpu_top_command += ["-d", "sriov"]

-    p = sp.run(
-        intel_gpu_top_command,
-        encoding="ascii",
-        capture_output=True,
-    )
+    try:
+        p = sp.run(
+            intel_gpu_top_command,
+            encoding="ascii",
+            capture_output=True,
+        )
+    except UnicodeDecodeError:
+        return None

    # timeout has a non-zero returncode when timeout is reached
    if p.returncode != 124:
@@ -748,3 +752,19 @@ def process_logs(
        log_lines.append(dedup_message)

    return len(log_lines), log_lines[start:end]
+
+
+def set_file_limit() -> None:
+    # Newer versions of containerd 2.X+ impose a very low soft file limit of 1024
+    # This applies to OSs like HA OS (see https://github.com/home-assistant/operating-system/issues/4110)
+    # Attempt to increase this limit
+    soft_limit = int(os.getenv("SOFT_FILE_LIMIT", "65536") or "65536")
+
+    current_soft, current_hard = resource.getrlimit(resource.RLIMIT_NOFILE)
+    logger.debug(f"Current file limits - Soft: {current_soft}, Hard: {current_hard}")
+
+    new_soft = min(soft_limit, current_hard)
+    resource.setrlimit(resource.RLIMIT_NOFILE, (new_soft, current_hard))
+    logger.debug(
+        f"File limit set. New soft limit: {new_soft}, Hard limit remains: {current_hard}"
+    )
@@ -59,6 +59,11 @@ def create_ground_plane(zone_points, distances):
        :param y: Y-coordinate in the image
        :return: Real-world distance per pixel at the given (x, y) coordinate
        """
+
+        # Return 0 if divide by zero would occur
+        if (B[0] - A[0]) == 0 or (D[1] - A[1]) == 0:
+            return 0
+
        # Normalize x and y within the zone
        x_norm = (x - A[0]) / (B[0] - A[0])
        y_norm = (y - A[1]) / (D[1] - A[1])
@@ -208,7 +208,35 @@ class CameraWatchdog(threading.Thread):

        return self.config.enabled

-    def run(self):
+    def reset_capture_thread(
+        self, terminate: bool = True, drain_output: bool = True
+    ) -> None:
+        if terminate:
+            self.ffmpeg_detect_process.terminate()
+            try:
+                self.logger.info("Waiting for ffmpeg to exit gracefully...")
+
+                if drain_output:
+                    self.ffmpeg_detect_process.communicate(timeout=30)
+                else:
+                    self.ffmpeg_detect_process.wait(timeout=30)
+            except sp.TimeoutExpired:
+                self.logger.info("FFmpeg did not exit. Force killing...")
+                self.ffmpeg_detect_process.kill()
+
+                if drain_output:
+                    self.ffmpeg_detect_process.communicate()
+                else:
+                    self.ffmpeg_detect_process.wait()
+
+        self.logger.error(
+            "The following ffmpeg logs include the last 100 lines prior to exit."
+        )
+        self.logpipe.dump()
+        self.logger.info("Restarting ffmpeg...")
+        self.start_ffmpeg_detect()
+
+    def run(self) -> None:
        if self._update_enabled_state():
            self.start_all_ffmpeg()

@@ -235,24 +263,7 @@ class CameraWatchdog(threading.Thread):
                self.logger.error(
                    f"Ffmpeg process crashed unexpectedly for {self.camera_name}."
                )
-                self.logger.error(
-                    "The following ffmpeg logs include the last 100 lines prior to exit."
-                )
-                self.logpipe.dump()
-                self.start_ffmpeg_detect()
-            elif now - self.capture_thread.current_frame.value > 20:
-                self.camera_fps.value = 0
-                self.logger.info(
-                    f"No frames received from {self.camera_name} in 20 seconds. Exiting ffmpeg..."
-                )
-                self.ffmpeg_detect_process.terminate()
-                try:
-                    self.logger.info("Waiting for ffmpeg to exit gracefully...")
-                    self.ffmpeg_detect_process.communicate(timeout=30)
-                except sp.TimeoutExpired:
-                    self.logger.info("FFmpeg did not exit. Force killing...")
-                    self.ffmpeg_detect_process.kill()
-                    self.ffmpeg_detect_process.communicate()
+                self.reset_capture_thread(terminate=False)
            elif self.camera_fps.value >= (self.config.detect.fps + 10):
                self.fps_overflow_count += 1

@@ -262,14 +273,13 @@ class CameraWatchdog(threading.Thread):
                    self.logger.info(
                        f"{self.camera_name} exceeded fps limit. Exiting ffmpeg..."
                    )
-                    self.ffmpeg_detect_process.terminate()
-                    try:
-                        self.logger.info("Waiting for ffmpeg to exit gracefully...")
-                        self.ffmpeg_detect_process.communicate(timeout=30)
-                    except sp.TimeoutExpired:
-                        self.logger.info("FFmpeg did not exit. Force killing...")
-                        self.ffmpeg_detect_process.kill()
-                        self.ffmpeg_detect_process.communicate()
+                    self.reset_capture_thread(drain_output=False)
+            elif now - self.capture_thread.current_frame.value > 20:
+                self.camera_fps.value = 0
+                self.logger.info(
+                    f"No frames received from {self.camera_name} in 20 seconds. Exiting ffmpeg..."
+                )
+                self.reset_capture_thread()
            else:
                # process is running normally
                self.fps_overflow_count = 0
@@ -8,7 +8,7 @@
  "chewing": "مَضْغ",
  "yodeling": "غناء متقلب",
  "howl": "عُوَاء",
-  "speech": "كلام",
+  "speech": "تحدث",
  "hiccup": "فُوَاق",
  "dog": "كَلْب",
  "yip": "نُبَيْحَة",
@@ -67,5 +67,8 @@
  "caterwaul": "صُرَاخ مُتَوَاصِل",
  "livestock": "مَاشِيَة",
  "horse": "حِصَان",
-  "clip_clop": "حَوَافِر الخَيْل"
+  "clip_clop": "حَوَافِر الخَيْل",
+  "car": "سيارة",
+  "motorcycle": "دراجة نارية",
+  "bicycle": "دراجة هوائية"
 }
@@ -1 +1,8 @@
-{}
+{
+  "time": {
+    "untilForTime": "حتى {{time}}",
+    "untilForRestart": "حتى يعاد تشغيل فرايجيت.",
+    "untilRestart": "حتى إعادة التشغيل",
+    "ago": "منذ {{timeAgo}}"
+  }
+}
@@ -1 +1,10 @@
-{}
+{
+  "form": {
+    "password": "كلمة السر",
+    "user": "أسم المستخدم",
+    "login": "تسجيل الدخول",
+    "errors": {
+      "usernameRequired": "اسم المستخدم مطلوب"
+    }
+  }
+}
@@ -1 +1,10 @@
-{}
+{
+  "group": {
+    "label": "مجموعات الكاميرات",
+    "add": "إضافة مجموعة الكاميرات",
+    "edit": "تعديل مجموعة الكاميرات",
+    "delete": {
+      "label": "حذف مجموعة الكاميرات"
+    }
+  }
+}
@@ -1 +1,9 @@
-{}
+{
+  "restart": {
+    "title": "هل أنت متأكد أنك تريد إعادة تشغيل فرايجيت؟",
+    "button": "إعادة التشغيل",
+    "restarting": {
+      "title": "يتم إعادة تشغيل فرايجيت"
+    }
+  }
+}
@@ -1 +1,9 @@
-{}
+{
+  "filter": "ترشيح",
+  "labels": {
+    "label": "التسميات",
+    "all": {
+      "title": "كل التسميات"
+    }
+  }
+}
@@ -1 +1,8 @@
-{}
+{
+  "iconPicker": {
+    "selectIcon": "اختر أيقونة",
+    "search": {
+      "placeholder": "ابحث عن أيقونة…"
+    }
+  }
+}
@@ -1 +1,10 @@
-{}
+{
+  "button": {
+    "downloadVideo": {
+      "label": "تحميل الفيديو",
+      "toast": {
+        "success": "تم بدأ تحميل فيديو عنصر المراجعة."
+      }
+    }
+  }
+}
@@ -1 +1,8 @@
-{}
+{
+  "noRecordingsFoundForThisTime": "لا يوجد تسجيلات في هذا التوقيت",
+  "noPreviewFound": "لا يوجد معاينة",
+  "noPreviewFoundFor": "لا يوجد معاينة لـ{{cameraName}}",
+  "submitFrigatePlus": {
+    "title": "هل ترغب بإرسال هذه الصوره الى Frigate+؟"
+  }
+}
@@ -3,5 +3,9 @@
  "cat": "قِطّ",
  "horse": "حِصَان",
  "animal": "حَيَوَان",
-  "bark": "نُبَاح"
+  "bark": "نُبَاح",
+  "person": "شخص",
+  "bicycle": "دراجة هوائية",
+  "car": "سيارة",
+  "motorcycle": "دراجة نارية"
 }
@@ -1 +1,6 @@
-{}
+{
+  "documentTitle": "محرر الإعدادات - فرايجيت",
+  "configEditor": "محرر الإعدادات",
+  "copyConfig": "نسخ الإعدادات",
+  "saveAndRestart": "حفظ وإعادة تشغيل"
+}
@@ -1 +1,8 @@
-{}
+{
+  "detections": "الإكتشافات",
+  "alerts": "الإنذارات",
+  "motion": {
+    "label": "الحركة",
+    "only": "حركة فقط"
+  }
+}
@@ -1 +1,8 @@
-{}
+{
+  "exploreMore": "اكتشف المزيد من أجسام {{label}}",
+  "documentTitle": "اكتشف - فرايجيت",
+  "generativeAI": "ذكاء اصطناعي مولد",
+  "exploreIsUnavailable": {
+    "title": "المتصفح غير متاح"
+  }
+}
@@ -1 +1,5 @@
-{}
+{
+  "search": "بحث",
+  "noExports": "لا يوجد تصديرات",
+  "documentTitle": "التصدير - فرايجيت"
+}
@@ -1 +1,10 @@
-{}
+{
+  "description": {
+    "addFace": "قم بإضافة مجموعة جديدة لمكتبة الأوجه.",
+    "invalidName": "أسم غير صالح. يجب أن يشمل الأسم فقط على الحروف، الأرقام، المسافات، الفاصلة العليا، الشرطة التحتية، والشرطة الواصلة.",
+    "placeholder": "أدخل أسم لهذه المجموعة"
+  },
+  "details": {
+    "person": "شخص"
+  }
+}
@@ -1 +1,8 @@
-{}
+{
+  "documentTitle": "بث حي - فرايجيت",
+  "documentTitle.withCamera": "{{camera}} - بث حي - فرايجيت",
+  "lowBandwidthMode": "وضع موفر للبيانات",
+  "twoWayTalk": {
+    "enable": "تفعيل المكالمات ثنائية الاتجاه"
+  }
+}
@@ -1 +1,5 @@
-{}
+{
+  "filter": "ترشيح",
+  "export": "إرسال",
+  "calendar": "التقويم"
+}
@@ -1 +1,5 @@
-{}
+{
+  "search": "بحث",
+  "savedSearches": "عمليات البحث المحفوظة",
+  "searchFor": "البحث عن {{inputValue}}"
+}
@@ -1 +1,7 @@
-{}
+{
+  "documentTitle": {
+    "camera": "إعدادات الكاميرا - فرايجيت",
+    "default": "الإعدادات - فرايجيت",
+    "authentication": "إعدادات المصادقة - فرايجيت"
+  }
+}
@@ -1 +1,7 @@
-{}
+{
+  "documentTitle": {
+    "cameras": "إحصاءات الكاميرات - فرايجيت",
+    "storage": "إحصاءات التخزين - فرايجيت",
+    "general": "إحصاءات عامة - فرايجيت"
+  }
+}
@@ -1 +1,3 @@
-{}
+{
+  "babbling": "Бърборене"
+}
@@ -1,6 +1,64 @@
 {
  "time": {
    "today": "Днес",
-    "yesterday": "Вчера"
+    "yesterday": "Вчера",
+    "month_one": "{{time}} месец",
+    "month_other": "{{time}} месеца",
+    "day_one": "{{time}} ден",
+    "day_other": "{{time}} дни",
+    "hour_one": "{{time}} час",
+    "hour_other": "{{time}} часа",
+    "minute_one": "{{time}} минута",
+    "minute_other": "{{time}} минути",
+    "second_one": "{{time}} секунда",
+    "second_other": "{{time}} секунди",
+    "year_one": "{{time}} година",
+    "year_other": "{{time}} години"
+  },
+  "button": {
+    "apply": "Приложи",
+    "reset": "Нулиране",
+    "done": "Готово",
+    "disabled": "Деактивирано",
+    "save": "Запази",
+    "saving": "Запазване…",
+    "cancel": "Отказ",
+    "close": "Затвори",
+    "copy": "Копирай",
+    "edit": "Редактирай",
+    "copyCoordinates": "Копирай координати",
+    "delete": "Изтриване",
+    "yes": "Да",
+    "download": "Изтегляне",
+    "enabled": "Активирано",
+    "history": "История",
+    "back": "Назад",
+    "fullscreen": "Цял екран",
+    "exitFullscreen": "Излез от цял екран",
+    "pictureInPicture": "Картина в картина",
+    "twoWayTalk": "Двупосочни разговори",
+    "cameraAudio": "Аудио на камерата",
+    "on": "Включено",
+    "off": "Изключено",
+    "no": "Не",
+    "info": "Информация",
+    "suspended": "Спряно",
+    "unsuspended": "Възобновяване",
+    "play": "Пускане",
+    "unselect": "Демаркиране",
+    "export": "Експортиране",
+    "deleteNow": "Изтрии сега",
+    "next": "Следващ",
+    "disable": "Деактивирай",
+    "enable": "Активирай"
+  },
+  "menu": {
+    "live": {
+      "title": "Наживо",
+      "cameras": {
+        "count_one": "{{count}} камера",
+        "count_other": "{{count}} камери"
+      }
+    }
  }
 }
@@ -1 +1,12 @@
-{}
+{
+  "export": {
+    "name": {
+      "placeholder": "Име на експорта"
+    },
+    "time": {
+      "lastHour_one": "Последният час",
+      "lastHour_other": "Последните {{count}} часа"
+    },
+    "select": "Избери"
+  }
+}
@@ -1 +1,34 @@
-{}
+{
+  "filter": "Филтър",
+  "cameras": {
+    "all": {
+      "title": "Всички камери",
+      "short": "Камери"
+    }
+  },
+  "logSettings": {
+    "allLogs": "Всички логове"
+  },
+  "subLabels": {
+    "all": "Всички подетикети",
+    "label": "Подетикети"
+  },
+  "labels": {
+    "all": {
+      "title": "Всички етикети",
+      "short": "Етикети"
+    }
+  },
+  "zones": {
+    "all": {
+      "title": "Всички зони",
+      "short": "Зони"
+    }
+  },
+  "dates": {
+    "all": {
+      "title": "Всички дати",
+      "short": "Дати"
+    }
+  }
+}
@@ -1 +1,51 @@
-{}
+{
+  "noPreviewFoundFor": "Не е намерен предварителен преглед за {{cameraName}}",
+  "stats": {
+    "latency": {
+      "short": {
+        "value": "{{seconds}} сек",
+        "title": "Закъснение"
+      },
+      "title": "Закъснение:",
+      "value": "{{seconds}} секунди"
+    },
+    "streamType": {
+      "title": "Тип поток:",
+      "short": "Тип"
+    },
+    "bandwidth": {
+      "title": "Трафик:",
+      "short": "Трафик"
+    },
+    "totalFrames": "Общо кадри:",
+    "droppedFrames": {
+      "title": "Пропуснати кадри:",
+      "short": {
+        "title": "Пропуснати",
+        "value": "{{droppedFrames}} кадри"
+      }
+    },
+    "decodedFrames": "Декодирани кадри:",
+    "droppedFrameRate": "Честота на пропуснатати кадри:"
+  },
+  "streamOffline": {
+    "desc": "Не са получени кадри в потока за <code>разпознаване</code> на {{cameraName}}, проверете лог файловете за грешки",
+    "title": "Потокът е офлайн"
+  },
+  "submitFrigatePlus": {
+    "title": "Да се изпрати ли този кадър към Frigate+?",
+    "submit": "Изпрати"
+  },
+  "noPreviewFound": "Не е намерен предварителен преглед",
+  "noRecordingsFoundForThisTime": "За това време не са намерени записи",
+  "livePlayerRequiredIOSVersion": "За този тип поток на живо се изисква iOS 17.1 или по-нова версия.",
+  "cameraDisabled": "Камерата е изключена",
+  "toast": {
+    "success": {
+      "submittedFrigatePlus": "Успешно изпратен кадър към Frigate+"
+    },
+    "error": {
+      "submitFrigatePlusFailed": "Неуспешно изпратен кадър към Frigate+"
+    }
+  }
+}
@@ -1 +1,13 @@
-{}
+{
+  "timeline.aria": "Избери хронология",
+  "timeline": "Хронология",
+  "calendarFilter": {
+    "last24Hours": "Последните 24 часа"
+  },
+  "events": {
+    "label": "Събития",
+    "aria": "Избери събития",
+    "noFoundForTimePeriod": "Няма намерени събития за този времеви период."
+  },
+  "allCameras": "Всички камери"
+}
@@ -1 +1,12 @@
-{}
+{
+  "details": {
+    "item": {
+      "tips": {
+        "mismatch_one": "{{count}} недостъпен обект беше открит и включен в този елемент за преглед. Тези обекти или не са квалифицирани като предупреждение или откриване, или вече са били изчистени/изтрити.",
+        "mismatch_other": "{{count}} недостъпни обекта бяха открити и включени в този елемент за преглед. Тези обекти или не са квалифицирани като предупреждение или откриване, или вече са били изчистени/изтрити."
+      }
+    }
+  },
+  "trackedObjectsCount_one": "{{count}} проследен обект ",
+  "trackedObjectsCount_other": "{{count}} проследени обекта "
+}
@@ -1 +1,14 @@
-{}
+{
+  "deleteFaceAttempts": {
+    "desc_one": "Сигурни ли сте, че искате да изтриете {{count}} лице? Това действие не може да бъде отменено.",
+    "desc_other": "Сигурни ли сте, че искате да изтриете {{count}} лица? Това действие не може да бъде отменено."
+  },
+  "toast": {
+    "success": {
+      "deletedFace_one": "Успешно изтрито {{count}} лице.",
+      "deletedFace_other": "Успешно изтрити {{count}} лица.",
+      "deletedName_one": "{{count}} лице бе изтрито успешно.",
+      "deletedName_other": "{{count}} лица бяха изтрити успешно."
+    }
+  }
+}
--- a/Show More
+++ b/Show More