stream integration provides a way to proxy live streams through Home Assistant. The integration currently only supports proxying H.264 source streams to the HLS format and requires at least FFmpeg >= 4.
To enable this component, add the following lines to your
# Example configuration.yaml entry stream:
Once loaded, the
stream platform will expose services that can be called to perform various actions.
.mp4 recording from a provided stream. While this service can be called directly, it is used internally by the
lookback options are suggestions, but should be consistent per stream. The actual length of the recording may vary. It is suggested that you tweak these settings to fit your needs.
|Service data attribute||Optional||Description|
||no||The input source for the stream, e.g.,
||no||The file name string. e.g.,
||yes||Target recording length (in seconds). Default: 30|
||yes||Target lookback period (in seconds) to include in addition to duration. Only available if there is currently an active HLS stream for
The path part of
filename must be an entry in the
allowlist_external_dirs in your
homeassistant: section of your
For example, the following action in an automation would take a recording from
rtsp://my.stream.feed:554 and save it to
action: service: camera.record target: entity_id: camera.quintal data: filename: "/config/www/my_stream.mp4" duration: 30
As of Home Assistant version 0.92 you can now live-stream a camera feed directly in lovelace.
To do this add either picture-entity, picture-glance or picture-elements, set
camera_image to a stream-ready camera entity and set
live in one of your Lovelace views.
Users on manual installs with FFmpeg < 4 may see an error similar to:
2020-04-28 13:35:43 ERROR (SyncWorker_5) [homeassistant.util.package] Unable to install package av==7.0.1: ERROR: Command errored out with exit status 1: command: /mnt/c/dev/home-assistant/venv/bin/python3.7 -u -c 'import sys, setuptools, tokenize; sys.argv = '"'"'/tmp/pip-install-twd7glz2/av/setup.py'"'"'; __file__='"'"'/tmp/pip-install-twd7glz2/av/setup.py'"'"';f=getattr(tokenize, '"'"'open'"'"', open)(__file__);code=f.read().replace('"'"'\r\n'"'"', '"'"'\n'"'"');f.close();exec(compile(code, __file__, '"'"'exec'"'"'))' install --record /tmp/pip-record-x9tw2ql2/install-record.txt --single-version-externally-managed --compile --install-headers /mnt/c/dev/home-assistant/venv/include/site/python3.7/av cwd: /tmp/pip-install-twd7glz2/av/
You can solve this by running the following steps to update FFmpeg >= 4:
sudo add-apt-repository ppa:jonathonf/ffmpeg-4 sudo apt upgrade
Suggest an edit to this page, or provide/view feedback for this page.