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.


To enable your FFmpeg feed in your installation you must first configure the ffmpeg component, then add the following to your configuration.yaml file:

# Example configuration.yaml entry
  - platform: ffmpeg

Configuration Variables


(string)(Required)An FFmpeg-compatible input file, stream, or feed.


(string)(Optional)Override the name of your camera.


(string)(Optional)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.

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