Advanced

Advanced configuration#

`motion`#

Global motion detection config. These may also be defined at the camera level.

motion:
  # Optional: The threshold passed to cv2.threshold to determine if a pixel is different enough to be counted as motion. (default: shown below)
  # Increasing this value will make motion detection less sensitive and decreasing it will make motion detection more sensitive.
  # The value should be between 1 and 255.
  threshold: 25
  # Optional: Minimum size in pixels in the resized motion image that counts as motion
  # Increasing this value will prevent smaller areas of motion from being detected. Decreasing will make motion detection more sensitive to smaller
  # moving objects.
  contour_area: 100
  # Optional: Alpha value passed to cv2.accumulateWeighted when averaging the motion delta across multiple frames (default: shown below)
  # Higher values mean the current frame impacts the delta a lot, and a single raindrop may register as motion.
  # Too low and a fast moving person wont be detected as motion.
  delta_alpha: 0.2
  # Optional: Alpha value passed to cv2.accumulateWeighted when averaging frames to determine the background (default: shown below)
  # Higher values mean the current frame impacts the average a lot, and a new object will be averaged into the background faster.
  # Low values will cause things like moving shadows to be detected as motion for longer.
  # https://www.geeksforgeeks.org/background-subtraction-in-an-image-using-concept-of-running-average/
  frame_alpha: 0.2
  # Optional: Height of the resized motion frame  (default: 1/6th of the original frame height)
  # This operates as an efficient blur alternative. Higher values will result in more granular motion detection at the expense of higher CPU usage.
  # Lower values result in less CPU, but small changes may not register as motion.
  frame_height: 180

`detect`#

Global object detection settings. These may also be defined at the camera level.

detect:
  # Optional: Number of frames without a detection before frigate considers an object to be gone. (default: double the frame rate)
  max_disappeared: 10

`logger`#

Change the default log level for troubleshooting purposes.

logger:
  # Optional: default log level (default: shown below)
  default: info
  # Optional: module by module log level configuration
  logs:
    frigate.mqtt: error

Available log levels are: debug, info, warning, error, critical

Examples of available modules are:

frigate.app
frigate.mqtt
frigate.edgetpu
frigate.zeroconf
detector.<detector_name>
watchdog.<camera_name>
ffmpeg.<camera_name>.<sorted_roles> NOTE: All FFmpeg logs are sent as error level.

`environment_vars`#

This section can be used to set environment variables for those unable to modify the environment of the container (ie. within Hass.io)

environment_vars:
  EXAMPLE_VAR: value

`database`#

Event and clip information is managed in a sqlite database at /media/frigate/clips/frigate.db. If that database is deleted, clips will be orphaned and will need to be cleaned up manually. They also won't show up in the Media Browser within HomeAssistant.

If you are storing your clips on a network share (SMB, NFS, etc), you may get a database is locked error message on startup. You can customize the location of the database in the config if necessary.

This may need to be in a custom location if network storage is used for clips.

database:
  path: /media/frigate/clips/frigate.db

`detectors`#

detectors:
  # Required: name of the detector
  coral:
    # Required: type of the detector
    # Valid values are 'edgetpu' (requires device property below) and 'cpu'. type: edgetpu
    # Optional: device name as defined here: https://coral.ai/docs/edgetpu/multiple-edgetpu/#using-the-tensorflow-lite-python-api
    device: usb
    # Optional: num_threads value passed to the tflite.Interpreter (default: shown below)
    # This value is only used for CPU types
    num_threads: 3

`model`#

model:
  # Required: height of the trained model
  height: 320
  # Required: width of the trained model
  width: 320

Custom Models#

Models for both CPU and EdgeTPU (Coral) are bundled in the image. You can use your own models with volume mounts:

CPU Model: /cpu_model.tflite
EdgeTPU Model: /edgetpu_model.tflite
Labels: /labelmap.txt

You also need to update the model width/height in the config if they differ from the defaults.

Customizing the Labelmap#

The labelmap can be customized to your needs. A common reason to do this is to combine multiple object types that are easily confused when you don't need to be as granular such as car/truck. You must retain the same number of labels, but you can change the names. To change:

Download the COCO labelmap
Modify the label names as desired. For example, change 7 truck to 7 car
Mount the new file at /labelmap.txt in the container with an additional volume
-v ./config/labelmap.txt:/labelmap.txt

Cameras

Setting Up Camera Inputs#

Up to 4 inputs can be configured for each camera and the role of each input can be mixed and matched based on your needs. This allows you to use a lower resolution stream for object detection, but create clips from a higher resolution stream, or vice versa.

Each role can only be assigned to one input per camera. The options for roles are as follows:

Role	Description
`detect`	Main feed for object detection
`clips`	Clips of events from objects detected in the `detect` feed. docs
`record`	Saves 60 second segments of the video feed. docs
`rtmp`	Broadcast as an RTMP feed for other services to consume. docs

Example#

mqtt:
  host: mqtt.server.com
cameras:
  back:
    ffmpeg:
      inputs:
        - path: rtsp://viewer:{FRIGATE_RTSP_PASSWORD}@10.0.10.10:554/cam/realmonitor?channel=1&subtype=2
          roles:
            - detect
            - rtmp
        - path: rtsp://viewer:{FRIGATE_RTSP_PASSWORD}@10.0.10.10:554/live
          roles:
            - clips
            - record
    width: 1280
    height: 720
    fps: 5

Masks & Zones#

Motion masks#

Masks are used to ignore initial detection in areas of your camera's field of view.

To create a poly mask:

Visit the web UI
Click the camera you wish to create a mask for
Click "Mask & Zone creator"
Click "Add" on the type of mask or zone you would like to create
Click on the camera's latest image to create a masked area. The yaml representation will be updated in real-time
When you've finished creating your mask, click "Copy" and paste the contents into your config.yaml file and restart Frigate

Example of a finished row corresponding to the below example image:

motion:
  mask: '0,461,3,0,1919,0,1919,843,1699,492,1344,458,1346,336,973,317,869,375,866,432'

poly

# Optional: camera level motion config
motion:
  # Optional: motion mask
  # NOTE: see docs for more detailed info on creating masks
  mask: 0,900,1080,900,1080,1920,0,1920

Zones#

Zones allow you to define a specific area of the frame and apply additional filters for object types so you can determine whether or not an object is within a particular area. Zones cannot have the same name as a camera. If desired, a single zone can include multiple cameras if you have multiple cameras covering the same area by configuring zones with the same name for each camera.

During testing, draw_zones should be set in the config to draw the zone on the frames so you can adjust as needed. The zone line will increase in thickness when any object enters the zone.

To create a zone, follow the same steps above for a "Motion mask", but use the section of the web UI for creating a zone instead.

# Optional: zones for this camera
zones:
  # Required: name of the zone
  # NOTE: This must be different than any camera names, but can match with another zone on another
  #       camera.
  front_steps:
    # Required: List of x,y coordinates to define the polygon of the zone.
    # NOTE: Coordinates can be generated at https://www.image-map.net/
    coordinates: 545,1077,747,939,788,805
    # Optional: Zone level object filters.
    # NOTE: The global and camera filters are applied upstream.
    filters:
      person:
        min_area: 5000
        max_area: 100000
        threshold: 0.7

Objects#

# Optional: Camera level object filters config.
objects:
  track:
    - person
    - car
  filters:
    person:
      min_area: 5000
      max_area: 100000
      min_score: 0.5
      threshold: 0.7
      # Optional: mask to prevent this object type from being detected in certain areas (default: no mask)
      # Checks based on the bottom center of the bounding box of the object
      mask: 0,0,1000,0,1000,200,0,200

Clips#

Frigate can save video clips without any CPU overhead for encoding by simply copying the stream directly with FFmpeg. It leverages FFmpeg's segment functionality to maintain a cache of video for each camera. The cache files are written to disk at /tmp/cache and do not introduce memory overhead. When an object is being tracked, it will extend the cache to ensure it can assemble a clip when the event ends. Once the event ends, it again uses FFmpeg to assemble a clip by combining the video clips without any encoding by the CPU. Assembled clips are are saved to /media/frigate/clips. Clips are retained according to the retention settings defined on the config for each object type.

caution

Previous versions of frigate included -vsync drop in input parameters. This is not compatible with FFmpeg's segment feature and must be removed from your input parameters if you have overrides set.

clips:
  # Required: enables clips for the camera (default: shown below)
  # This value can be set via MQTT and will be updated in startup based on retained value
  enabled: False
  # Optional: Number of seconds before the event to include in the clips (default: shown below)
  pre_capture: 5
  # Optional: Number of seconds after the event to include in the clips (default: shown below)
  post_capture: 5
  # Optional: Objects to save clips for. (default: all tracked objects)
  objects:
    - person
  # Optional: Camera override for retention settings (default: global values)
  retain:
    # Required: Default retention days (default: shown below)
    default: 10
    # Optional: Per object retention days
    objects:
      person: 15

Snapshots#

Frigate can save a snapshot image to /media/frigate/clips for each event named as <camera>-<id>.jpg.

# Optional: Configuration for the jpg snapshots written to the clips directory for each event
snapshots:
  # Optional: Enable writing jpg snapshot to /media/frigate/clips (default: shown below)
  # This value can be set via MQTT and will be updated in startup based on retained value
  enabled: False
  # Optional: print a timestamp on the snapshots (default: shown below)
  timestamp: False
  # Optional: draw bounding box on the snapshots (default: shown below)
  bounding_box: False
  # Optional: crop the snapshot (default: shown below)
  crop: False
  # Optional: height to resize the snapshot to (default: original size)
  height: 175
  # Optional: Camera override for retention settings (default: global values)
  retain:
    # Required: Default retention days (default: shown below)
    default: 10
    # Optional: Per object retention days
    objects:
      person: 15

24/7 Recordings#

24/7 recordings can be enabled and are stored at /media/frigate/recordings. The folder structure for the recordings is YYYY-MM/DD/HH/<camera_name>/MM.SS.mp4. These recordings are written directly from your camera stream without re-encoding and are available in HomeAssistant's media browser. Each camera supports a configurable retention policy in the config.

caution

Previous versions of frigate included -vsync drop in input parameters. This is not compatible with FFmpeg's segment feature and must be removed from your input parameters if you have overrides set.

# Optional: 24/7 recording configuration
record:
  # Optional: Enable recording (default: global setting)
  enabled: False
  # Optional: Number of days to retain (default: global setting)
  retain_days: 30

RTMP streams#

Frigate can re-stream your video feed as a RTMP feed for other applications such as HomeAssistant to utilize it at rtmp://<frigate_host>/live/<camera_name>. Port 1935 must be open. This allows you to use a video feed for detection in frigate and HomeAssistant live view at the same time without having to make two separate connections to the camera. The video feed is copied from the original video feed directly to avoid re-encoding. This feed does not include any annotation by Frigate.

Some video feeds are not compatible with RTMP. If you are experiencing issues, check to make sure your camera feed is h264 with AAC audio. If your camera doesn't support a compatible format for RTMP, you can use the ffmpeg args to re-encode it on the fly at the expense of increased CPU utilization.

Full example#

The following is a full example of all of the options together for a camera configuration

cameras:
  # Required: name of the camera
  back:
    # Required: ffmpeg settings for the camera
    ffmpeg:
      # Required: A list of input streams for the camera. See documentation for more information.
      inputs:
        # Required: the path to the stream
        # NOTE: Environment variables that begin with 'FRIGATE_' may be referenced in {}
        - path: rtsp://viewer:{FRIGATE_RTSP_PASSWORD}@10.0.10.10:554/cam/realmonitor?channel=1&subtype=2
          # Required: list of roles for this stream. valid values are: detect,record,clips,rtmp
          # NOTICE: In addition to assigning the record, clips, and rtmp roles,
          # they must also be enabled in the camera config.
          roles:
            - detect
            - rtmp
          # Optional: stream specific global args (default: inherit)
          global_args:
          # Optional: stream specific hwaccel args (default: inherit)
          hwaccel_args:
          # Optional: stream specific input args (default: inherit)
          input_args:

+
      # Optional: camera specific global args (default: inherit)
      global_args:
      # Optional: camera specific hwaccel args (default: inherit)
      hwaccel_args:
      # Optional: camera specific input args (default: inherit)
      input_args:
      # Optional: camera specific output args (default: inherit)
      output_args:

+
    # Required: width of the frame for the input with the detect role
    width: 1280
    # Required: height of the frame for the input with the detect role
    height: 720
    # Optional: desired fps for your camera for the input with the detect role
    # NOTE: Recommended value of 5. Ideally, try and reduce your FPS on the camera.
    #       Frigate will attempt to autodetect if not specified.
    fps: 5

+
    # Optional: camera level motion config
    motion:
      # Optional: motion mask
      # NOTE: see docs for more detailed info on creating masks
      mask: 0,900,1080,900,1080,1920,0,1920

+
    # Optional: timeout for highest scoring image before allowing it
    # to be replaced by a newer image. (default: shown below)
    best_image_timeout: 60

+
    # Optional: zones for this camera
    zones:
      # Required: name of the zone
      # NOTE: This must be different than any camera names, but can match with another zone on another
      #       camera.
      front_steps:
        # Required: List of x,y coordinates to define the polygon of the zone.
        # NOTE: Coordinates can be generated at https://www.image-map.net/
        coordinates: 545,1077,747,939,788,805
        # Optional: Zone level object filters.
        # NOTE: The global and camera filters are applied upstream.
        filters:
          person:
            min_area: 5000
            max_area: 100000
            threshold: 0.7

+
    # Optional: Camera level detect settings
    detect:
      # Optional: enables detection for the camera (default: True)
      # This value can be set via MQTT and will be updated in startup based on retained value
      enabled: True
      # Optional: Number of frames without a detection before frigate considers an object to be gone. (default: double the frame rate)
      max_disappeared: 10

+
    # Optional: save clips configuration
    clips:
      # Required: enables clips for the camera (default: shown below)
      # This value can be set via MQTT and will be updated in startup based on retained value
      enabled: False
      # Optional: Number of seconds before the event to include in the clips (default: shown below)
      pre_capture: 5
      # Optional: Number of seconds after the event to include in the clips (default: shown below)
      post_capture: 5
      # Optional: Objects to save clips for. (default: all tracked objects)
      objects:
        - person
      # Optional: Camera override for retention settings (default: global values)
      retain:
        # Required: Default retention days (default: shown below)
        default: 10
        # Optional: Per object retention days
        objects:
          person: 15

+
    # Optional: 24/7 recording configuration
    record:
      # Optional: Enable recording (default: global setting)
      enabled: False
      # Optional: Number of days to retain (default: global setting)
      retain_days: 30

+
    # Optional: RTMP re-stream configuration
    rtmp:
      # Required: Enable the live stream (default: True)
      enabled: True

+
    # Optional: Configuration for the jpg snapshots written to the clips directory for each event
    snapshots:
      # Optional: Enable writing jpg snapshot to /media/frigate/clips (default: shown below)
      # This value can be set via MQTT and will be updated in startup based on retained value
      enabled: False
      # Optional: print a timestamp on the snapshots (default: shown below)
      timestamp: False
      # Optional: draw bounding box on the snapshots (default: shown below)
      bounding_box: False
      # Optional: crop the snapshot (default: shown below)
      crop: False
      # Optional: height to resize the snapshot to (default: original size)
      height: 175
      # Optional: Camera override for retention settings (default: global values)
      retain:
        # Required: Default retention days (default: shown below)
        default: 10
        # Optional: Per object retention days
        objects:
          person: 15

+
    # Optional: Configuration for the jpg snapshots published via MQTT
    mqtt:
      # Optional: Enable publishing snapshot via mqtt for camera (default: shown below)
      # NOTE: Only applies to publishing image data to MQTT via 'frigate/<camera_name>/<object_name>/snapshot'.
      # All other messages will still be published.
      enabled: True
      # Optional: print a timestamp on the snapshots (default: shown below)
      timestamp: True
      # Optional: draw bounding box on the snapshots (default: shown below)
      bounding_box: True
      # Optional: crop the snapshot (default: shown below)
      crop: True
      # Optional: height to resize the snapshot to (default: shown below)
      height: 270

+
    # Optional: Camera level object filters config.
    objects:
      track:
        - person
        - car
      filters:
        person:
          min_area: 5000
          max_area: 100000
          min_score: 0.5
          threshold: 0.7
          # Optional: mask to prevent this object type from being detected in certain areas (default: no mask)
          # Checks based on the bottom center of the bounding box of the object
          mask: 0,0,1000,0,1000,200,0,200

Camera specific configuration#

RTMP Cameras#

The input parameters need to be adjusted for RTMP cameras

ffmpeg:
  input_args:
    - -avoid_negative_ts
    - make_zero
    - -fflags
    - nobuffer
    - -flags
    - low_delay
    - -strict
    - experimental
    - -fflags
    - +genpts+discardcorrupt
    - -use_wallclock_as_timestamps
    - '1'

Blue Iris RTSP Cameras#

You will need to remove nobuffer flag for Blue Iris RTSP cameras

ffmpeg:
  input_args:
    - -avoid_negative_ts
    - make_zero
    - -flags
    - low_delay
    - -strict
    - experimental
    - -fflags
    - +genpts+discardcorrupt
    - -rtsp_transport
    - tcp
    - -stimeout
    - '5000000'
    - -use_wallclock_as_timestamps
    - '1'

Frame	Current Score	Score History	Computed Score	Detected Object
1	0.7	0.0, 0, 0.7	0.0	No
2	0.55	0.0, 0.7, 0.0	0.0	No
3	0.85	0.7, 0.0, 0.85	0.7	No
4	0.90	0.7, 0.85, 0.95, 0.90	0.875	Yes
5	0.88	0.7, 0.85, 0.95, 0.90, 0.88	0.88	Yes
6	0.95	0.7, 0.85, 0.95, 0.90, 0.88, 0.95	0.89	Yes

Name	Inference Speed	Notes
Atomic Pi	16ms	Good option for a dedicated low power board with a small number of cameras. Can leverage Intel QuickSync for stream decoding.
Intel NUC NUC7i3BNK	8-10ms	Great performance. Can handle many cameras at 5fps depending on typical amounts of motion.
BMAX B2 Plus	10-12ms	Good balance of performance and cost. Also capable of running many other services at the same time as frigate.
Minisforum GK41	9-10ms	Great alternative to a NUC with dual Gigabit NICs. Easily handles several 1080p cameras.
Raspberry Pi 3B (32bit)	60ms	Can handle a small number of cameras, but the detection speeds are slow due to USB 2.0.
Raspberry Pi 4 (32bit)	15-20ms	Can handle a small number of cameras. The 2GB version runs fine.
Raspberry Pi 4 (64bit)	10-15ms	Can handle a small number of cameras. The 2GB version runs fine.

param	Type	Description
`fps`	int	Frame rate
`h`	int	Height in pixels
`bbox`	int	Show bounding boxes for detected objects (0 or 1)
`timestamp`	int	Print the timestamp in the upper left (0 or 1)
`zones`	int	Draw the zones on the image (0 or 1)
`mask`	int	Overlay the mask on the image (0 or 1)
`motion`	int	Draw blue boxes for areas with detected motion (0 or 1)
`regions`	int	Draw green boxes for areas where object detection was run (0 or 1)

param	Type	Description
`h`	int	Height in pixels
`bbox`	int	Show bounding boxes for detected objects (0 or 1)
`timestamp`	int	Print the timestamp in the upper left (0 or 1)
`zones`	int	Draw the zones on the image (0 or 1)
`mask`	int	Overlay the mask on the image (0 or 1)
`motion`	int	Draw blue boxes for areas with detected motion (0 or 1)
`regions`	int	Draw green boxes for areas where object detection was run (0 or 1)

param	Type	Description
`before`	int	Epoch time
`after`	int	Epoch time
`camera`	str	Camera name
`label`	str	Label name
`zone`	str	Zone name
`limit`	int	Limit the number of events returned
`has_snapshot`	int	Filter to events that have snapshots (0 or 1)
`has_clip`	int	Filter to events that have clips (0 or 1)

Page Not Found

Advanced configuration#

motion#

detect#

logger#

environment_vars#

database#

detectors#

model#

Custom Models#

Customizing the Labelmap#

Setting Up Camera Inputs#

Example#

Masks & Zones#

Motion masks#

Zones#

Objects#

Clips#

caution

Snapshots#

24/7 Recordings#

caution

RTMP streams#

Full example#

Camera specific configuration#

RTMP Cameras#

Blue Iris RTSP Cameras#

Required#

mqtt#

cameras#

Optional#

clips#

ffmpeg#

objects#

Docker setup#

Requirements#

Setting up docker-compose#

Setting up the configuration file#

FFmpeg Hardware Acceleration#

Cameras#

Computer#

Screenshots#

HassOS Addon#

Docker#

Kubernetes#

Virtualization#

Proxmox#

Calculating shm-size#

"[mov,mp4,m4a,3gp,3g2,mj2 @ 0x5639eeb6e140] moov atom not found"#

"ffmpeg didnt return a frame. something is wrong"#

"On connect called"#

/api/<camera_name>#

/api/<camera_name>/<object_name>/best.jpg[?h=300&crop=1]#

/api/<camera_name>/latest.jpg[?h=300]#

/api/stats#

/api/config#

/api/version#

/api/events#

/api/events/summary#

/api/events/<id>#

/api/events/<id>/thumbnail.jpg#

/clips/<camera>-<id>.mp4#

/clips/<camera>-<id>.jpg#

Sensors:#

Cameras:#

Media Browser:#

API:#

Notifications#

frigate/available#

frigate/<camera_name>/<object_name>#

frigate/<zone_name>/<object_name>#

frigate/<camera_name>/<object_name>/snapshot#

frigate/events#

frigate/stats#

frigate/<camera_name>/detect/set#

frigate/<camera_name>/detect/state#

frigate/<camera_name>/clips/set#

frigate/<camera_name>/clips/state#

frigate/<camera_name>/snapshots/set#

frigate/<camera_name>/snapshots/state#

`motion`#

`detect`#

`logger`#

`environment_vars`#

`database`#

`detectors`#

`model`#

`mqtt`#

`cameras`#

`clips`#

`ffmpeg`#

`objects`#

`/api/<camera_name>`#

`/api/<camera_name>/<object_name>/best.jpg[?h=300&crop=1]`#

`/api/<camera_name>/latest.jpg[?h=300]`#

`/api/stats`#

`/api/config`#

`/api/version`#

`/api/events`#

`/api/events/summary`#

`/api/events/<id>`#

`/api/events/<id>/thumbnail.jpg`#

`/clips/<camera>-<id>.mp4`#

`/clips/<camera>-<id>.jpg`#

`frigate/available`#

`frigate/<camera_name>/<object_name>`#

`frigate/<zone_name>/<object_name>`#

`frigate/<camera_name>/<object_name>/snapshot`#

`frigate/events`#

`frigate/stats`#

`frigate/<camera_name>/detect/set`#

`frigate/<camera_name>/detect/state`#

`frigate/<camera_name>/clips/set`#

`frigate/<camera_name>/clips/state`#

`frigate/<camera_name>/snapshots/set`#

`frigate/<camera_name>/snapshots/state`#