Libratone Zipp controller for Home Assistant

This aims to control a Libratone Zipp speaker within Home Assistant using this Python library.

Limitations / Known bugs

• Major:
  • On Bluetooth and when the music is playing, you only get "Play" button, not Pause.
• Minor:
  • After a restart of Home Assistant, the integration can be in an "unknown" state before the 1st music is played

Usage

Installation via HACS

1. Search for Libratone Zipp in the integration tab of HACS
2. Click Install
3. Restart Home Assistant
4. Go to Settings → Devices & services → Add integration and search for Libratone Zipp
5. Add the IP of the speaker and a name
6. Repeat the last step if you have multiple speakers

Note: if you're using Docker/devcontainer, you need to forward 3333/udp and 7778/udp.

Features

Functionality coverage

Current coverage suits me, even if the python integration has much more options. Don't expect new features (only maintenance) but feel free to open an issue or submit a PR!

• v1.0
  • Set up entity in home assistant
  • Basic playback status
  • Calculate status
• v2.0
  • Set a sound mode (voicing)
  • Use human names for Voicing / Sound mode
  • Retrieve basic playback status: play, pause, stop, next, prev
  • Set volume
  • Retrieve volume
  • Set to immediate standby (sleep)
  • Retrieve current Voicing
  • (kinda) Play a favorite (but it's only number)
• v3.0
  • Retrieve current title and sub-title
• v4.0
  • Manage multiple speakers
  • Add/Remove speakers via Web interface (no configuration.yaml anymore!)
• v4.1
  • Implement SoundSpace Link

Other functionalities - Not planned right now:

• Module
  • Make the module async
  • Submit it for official integration!
  • Add support for other libratone speakers
• Current Playback info
  • Retrieve current playback source
  • Retrieve media type: bluetooth, spotify, aux, radio, ...
• Standby
  • Set a standby timer
  • Retrieve a standby timer
• Voicing & Room Setting
  • Set Room Setting
  • Retrieve current Room Setting
• Favorites
  • Play a favorite (proper title)
  • Set a Favorite
• Extended current playback info
  • Set extended playback status: shuffle, repeat
  • Retrieve extended playback status: shuffle, repeat
  • Set Source
  • Retrieve current source
• Multi-room
  • Set speaker mode (stereo, left, right)
  • Add better media player cards

Acknowledgment

This work is based on the following:

• The first Libratone command list is coming from this work from Benjamin Hanke
• Entity to use: Media Player
• Example of integrations:
  • Simple: Harman Kardon AVR integration which use this module
  • Simple: Clementine Music Player integration which use this module
  • Async: Frontier Silicon integration with this module
  • Async with extended features: Yamaha integration with this module

License

See LICENSE file.