willholdoway / hifiberry

This is a custom component to allow control of HifiberryOS devices in Home Assistant using the audiocontrol2 REST API.
Creative Commons Zero v1.0 Universal
48 stars 11 forks source link
hacs hassio hifiberry home-assistant home-automation internet-of-things iot media-player python

HiFiBerry for Home Assistant

beta_badge hacs_badge License: CC0-1.0

The HiFiBerry HA integration allows controlling HifiBerry OS media players from Home Assistant.

This is an end-to-end streaming lightweight OS built by HiFiBerry for their Amp+, DAC+ or Digi+ HAT Raspberry Pi boards compatible with AirPlay, Bluetooth, DLNA, LMS/Squeezebox, MPD, Snapcast, Spotify and Roon music services. This uses the HiFiBerry audiocontrol2 socketio API.

Be aware that this API is disabled by default. In order to use this integration it has to be enabled in the /etc/audiocontrol2.conf on the device, an authtoken will also have to be added:

[webserver]
enable=yes
port=81
socketio_enabled=True
authtoken=[insert_custom_token_here]

Installation

It is recommended this is installed using Home Assistant Community Store (HACS) to ensure your Home Assistant instance can easily be kept up-to-date with the latest changes.

However, to install this manually, copy everything from /custom_components/hifiberry/ to your folder <config directory>/custom_components/hifiberry/.

Configuration

Installation

None required other than setting a fixed IP for the device running HiFiBerry.

Support

There is no official support for this add-on and is community supported within the Home Assistant HiFiBerry discussion thread.

If you have any proposed changes or bug fixes, please code them and create pull requests for your patches.

See Also