Skip to content

Control a Libratone Zipp speaker within Home Assistant

License

Notifications You must be signed in to change notification settings

Chouffy/home_assistant_libratone_zipp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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:

License

See LICENSE file.