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:
  • Only one speaker is supported - this needs this upstream module issue to be fixed
  • 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. Add the following in your /config/configuration.yaml:

   media_player:
   - platform: libratone_zipp
     host: 192.168.XX.XX
     name: Zipp
     scan_interval: 2

   • Only one speaker is supported!
   • I suggest scan_interval: 2 to get 2 seconds refresh rate

4. Restart the server

5. You need to forward 3333/udp and 7778/udp if you're using Docker/devcontainer

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

Other functionalities - Not planned right now:

• Module
  • Submit it for non-official integration on HACS - in progress
  • Re-enable automatic HACS workflow
  • Make the module async
  • Submit it for official integration!
• 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
  • Implement SoundSpace Link

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.