2025.6.1
Home ▸ Integrations ▸

FFmpeg Camera

The ffmpeg platform allows you to use any video feed as a camera in Home Assistant via FFmpeg. This video source must support multiple simultaneous reads, because for every concurrent Home Assistant user, a connection will be made to the source every 10 seconds. Normally this should not be a problem.

Configuration

To enable your FFmpeg feed in your installation you must first configure the FFmpeg integration, then add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file:

# Example configuration.yaml entry
camera:
  - platform: ffmpeg
    input: FFMPEG_SUPPORTED_INPUT

Configuration Variables

Looking for your configuration file?
input string Required

An FFmpeg-compatible input file, stream, or feed.

name string (Optional)

Override the name of your camera.

extra_arguments string (Optional, default: -pred 1)

Extra options to pass to ffmpeg, e.g., image quality or video filter options.

Image quality

You can control the image quality with extra_arguments -q:v 2-32 or with lossless option -pred 1. Default is lossless.

If you are running into trouble with this sensor, please refer to the Troubleshooting section.