Daniel Shokouhi f4c7638706 Add troubleshooting section (#8940)
* Add troubleshooting section

When I first attempted to setup the stream component in my dev environment I had the following errors that were only solved by installing these packages.  When I moved to a second pi to do further testing I again needed to run the same commands to setup the component so this will be helpful to any user who has the same error.

* Update stream.markdown
2019-03-15 10:49:28 -07:00

1.9 KiB

layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class ha_qa_scale
page Stream Instructions on how to integrate live streams within Home Assistant. 2019-02-06 13:40 true false true true home-assistant.png
Other
0.90 Local Push internal

The stream component provides a way to proxy live streams through Home Assistant. The component currently only supports the HLS format.

{% linkable_title Configuration %}

To enable this component, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
stream:

{% linkable_title Troubleshooting %}

Some users on manual installs may see the following error in their logs after restarting:

2019-03-12 08:49:59 ERROR (SyncWorker_5) [homeassistant.util.package] Unable to install package av==6.1.2: Command "/home/pi/home-assistant/bin/python3 -u -c "import setuptools, tokenize;__file__='/tmp/pip-install-udfl2b3t/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-ftn5zmh2/install-record.txt --single-version-externally-managed --compile --install-headers /home/pi/home-assistant/include/site/python3.6/av" failed with error code 1 in /tmp/pip-install-udfl2b3t/av/
2019-03-12 08:49:59 ERROR (MainThread) [homeassistant.requirements] Not initializing stream because could not install requirement av==6.1.2
2019-03-12 08:49:59 ERROR (MainThread) [homeassistant.setup] Setup failed for stream: Could not install all requirements.

If you see this error you can solve it by running the following commands and restarting Home Assistant (commands do not need to be ran as the homeassistant user):

sudo apt-get install -y python-dev pkg-config libavformat-dev libavcodec-dev libavdevice-dev libavutil-dev libswscale-dev libavresample-dev libavfilter-dev