frigate/docs/docs/configuration/ffmpeg_presets.md
Josh Hawkins 5a5d23b503
Some checks are pending
CI / AMD64 Build (push) Waiting to run
CI / ARM Build (push) Waiting to run
CI / Jetson Jetpack 6 (push) Waiting to run
CI / AMD64 Extra Build (push) Blocked by required conditions
CI / ARM Extra Build (push) Blocked by required conditions
CI / Synaptics Build (push) Blocked by required conditions
CI / Assemble and push default build (push) Blocked by required conditions
Docs refactor (#22703)
* add generation script

a script to read yaml code blocks from docs markdown files and generate corresponding "Frigate UI" tab instructions based on the json schema, i18n, section configs (hidden fields), and nav mappings

* first pass

* components

* add to gitignore

* second pass

* fix broken anchors

* fixes

* clean up tabs

* version bump

* tweaks

* remove role mapping config from ui
2026-03-30 10:36:45 -06:00

8.0 KiB

id title
ffmpeg_presets FFmpeg presets

import ConfigTabs from "@site/src/components/ConfigTabs"; import TabItem from "@theme/TabItem"; import NavPath from "@site/src/components/NavPath";

Some presets of FFmpeg args are provided by default to make the configuration easier. All presets can be seen in this file.

Hwaccel Presets

It is highly recommended to use hwaccel presets in the config. These presets not only replace the longer args, but they also give Frigate hints of what hardware is available and allows Frigate to make other optimizations using the GPU such as when encoding the birdseye restream or when scaling a stream that has a size different than the native stream size.

See the hwaccel docs for more info on how to setup hwaccel for your GPU / iGPU.

Preset Usage Other Notes
preset-rpi-64-h264 64 bit Rpi with h264 stream
preset-rpi-64-h265 64 bit Rpi with h265 stream
preset-vaapi Intel & AMD VAAPI Check hwaccel docs to ensure correct driver is chosen
preset-intel-qsv-h264 Intel QSV with h264 stream If issues occur recommend using vaapi preset instead
preset-intel-qsv-h265 Intel QSV with h265 stream If issues occur recommend using vaapi preset instead
preset-nvidia Nvidia GPU
preset-jetson-h264 Nvidia Jetson with h264 stream
preset-jetson-h265 Nvidia Jetson with h265 stream
preset-rkmpp Rockchip MPP Use image with *-rk suffix and privileged mode

Select the appropriate hwaccel preset for your hardware.

  1. Navigate to and set Hardware acceleration arguments to the appropriate preset for your hardware.
  2. To override for a specific camera, navigate to and set Hardware acceleration arguments for that camera.
ffmpeg:
  hwaccel_args: preset-vaapi

cameras:
  front_door:
    ffmpeg:
      hwaccel_args: preset-nvidia

Input Args Presets

Input args presets help make the config more readable and handle use cases for different types of streams to ensure maximum compatibility.

See the camera specific docs for more info on non-standard cameras and recommendations for using them in Frigate.

Preset Usage Other Notes
preset-http-jpeg-generic HTTP Live Jpeg Recommend restreaming live jpeg instead
preset-http-mjpeg-generic HTTP Mjpeg Stream Recommend restreaming mjpeg stream instead
preset-http-reolink Reolink HTTP-FLV Stream Only for reolink http, not when restreaming as rtsp
preset-rtmp-generic RTMP Stream
preset-rtsp-generic RTSP Stream This is the default when nothing is specified
preset-rtsp-restream RTSP Stream from restream Use for rtsp restream as source for frigate
preset-rtsp-restream-low-latency RTSP Stream from restream Use for rtsp restream as source for frigate to lower latency, may cause issues with some cameras
preset-rtsp-udp RTSP Stream via UDP Use when camera is UDP only
preset-rtsp-blue-iris Blue Iris RTSP Stream Use when consuming a stream from Blue Iris

:::warning

It is important to be mindful of input args when using restream because you can have a mix of protocols. http and rtmp presets cannot be used with rtsp streams. For example, when using a reolink cam with the rtsp restream as a source for record the preset-http-reolink will cause a crash. In this case presets will need to be set at the stream level. See the example below.

:::

go2rtc:
  streams:
    reolink_cam: http://192.168.0.139/flv?port=1935&app=bcs&stream=channel0_main.bcs&user=admin&password=password

cameras:
  reolink_cam:
    ffmpeg:
      inputs:
        - path: http://192.168.0.139/flv?port=1935&app=bcs&stream=channel0_ext.bcs&user=admin&password=password
          input_args: preset-http-reolink
          roles:
            - detect
        - path: rtsp://127.0.0.1:8554/reolink_cam
          input_args: preset-rtsp-generic
          roles:
            - record

Output Args Presets

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 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