make optional

This commit is contained in:
Josh Hawkins
2026-03-05 18:01:41 -06:00
parent 4a6f8b43b3
commit d6df6c28fd
6 changed files with 23 additions and 19 deletions
+7 -7
View File
@@ -110,18 +110,18 @@ Some cameras, like doorbell cameras, may have missed detections when someone wal
motion:
# Optional: Fraction of the frame that must change in a single update
# before Frigate will completely ignore any motion in that frame.
# Values range between 0.0 and 1.0, where 1.0 (the default) means
# the feature is disabled. Setting this to 0.7 would cause Frigate to
# **skip** reporting motion boxes when more than 70% of the image
# appears to change (e.g. during lightning storms, IR/color mode
# switches, or other sudden lighting events).
skip_motion_threshold: 1.0
# Values range between 0.0 and 1.0, leave unset (null) to disable.
# Setting this to 0.7 would cause Frigate to **skip** reporting
# motion boxes when more than 70% of the image appears to change
# (e.g. during lightning storms, IR/color mode switches, or other
# sudden lighting events).
skip_motion_threshold: 0.7
```
This option is handy when you want to prevent large transient changes from triggering recordings or object detection. It differs from `lightning_threshold` because it completely suppresses motion instead of just forcing a recalibration.
:::warning
When the skip threshold is exceeded, **no motion is reported** for that frame. That means you can miss something important, like a PTZ camera auto-tracking an object or activity while the camera is moving. If you prefer to guarantee that every frame is saved, leave motion enabled and accept occasional recordings containing scene noise — they typically only take up a few megabytes and are quick to scan in the timeline UI.
When the skip threshold is exceeded, **no motion is reported** for that frame, meaning **nothing is recorded** for that frame. That means you can miss something important, like a PTZ camera auto-tracking an object or activity while the camera is moving. If you prefer to guarantee that every frame is saved, leave this unset and accept occasional recordings containing scene noise — they typically only take up a few megabytes and are quick to scan in the timeline UI.
:::
+5 -4
View File
@@ -485,10 +485,11 @@ motion:
# 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.
lightning_threshold: 0.8
# Optional: The percentage of the image used to detect lightning or other substantial changes where motion detection needs to recalibrate
# When this threshold is exceeded the frame is entirely skipped for motion processing and **no motion recording** is retained.
# Use with care on PTZ cameras or other situations where you require guaranteed frame capture.
skip_motion_threshold: 1.0
# Optional: Fraction of the frame that must change in a single update before motion boxes are completely
# ignored. Values range between 0.0 and 1.0. When exceeded, no motion boxes are reported and **no motion
# recording** is created for that frame. Leave unset (null) to disable this feature. Use with care on PTZ
# cameras or other situations where you require guaranteed frame capture.
skip_motion_threshold: None
# Optional: Minimum size in pixels in the resized motion image that counts as motion (default: shown below)
# Increasing this value will prevent smaller areas of motion from being detected. Decreasing will
# make motion detection more sensitive to smaller moving objects.