home-assistant.io/source/_components/camera.ffmpeg.markdown
AlucardZero 67ad4a38f4 English editing for camera.ffmpeg.markdown
Note: I'm honestly not sure I understood the first paragraph correctly, so someone familiar with the FFmpeg code might want to check the information.
2016-10-02 14:39:30 -04:00

1.5 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout title description date sidebar comments sharing footer logo ha_category ha_release
page FFmpeg Camera Instructions on how to integrate a video feed via FFmpeg as a camera within Home Assistant. 2016-08-13 08:00 true false true true ffmpeg.png Camera 0.26

The ffmpeg platform allows you to use any video feed as camera in Home Assistant via FFmpeg. This video source must support multiple simultaenous 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, add the following to your configuration.yaml file:

# Example configuration.yaml entry
camera:
  - platform: ffmpeg
    input: FFMPEG_SUPPORTED_INPUT
    name: FFmpeg
    extra_arguments: -q:v 2

Configuration variables:

  • input (Required): An FFmpeg-compatible input file, stream, or feed.
  • name (Optional): Override the name of your camera.
  • extra_arguments (Optional): Extra options to pass to ffmpeg, e.g. image quality or video filter options.

{% linkable_title 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.