/hifiberry

This is a custom component to allow control of HifiberryOS devices in Home Assistant using the audiocontrol2 REST API.

Primary LanguagePythonCreative Commons Zero v1.0 UniversalCC0-1.0

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

  • Browse to your Home Assistant instance
  • In the sidebar click on Configuration
  • From the configuration menu select: Integrations
  • In the bottom right, click on the Add Integration button
  • From the list, search and select “HiFiBerry
  • Follow the instruction to complete the set up

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