python-libratone-zipp 2.0.0

Control a Libratone Zipp speaker with a Python library

Libratone Zipp controller library in Python

This aims to control a Libratone Zipp speaker with a Python library, potentially usable in Home Assistant with this module.

Install it with pip install python-libratone-zipp - pip page

Usage

See example in CLI.py. You have to be able to listen to 3333/udp and 7778/udp!

Roadmap

Nothing is guaranteed here!

Module improvement

• Clean text variables, declare variable on top instead of using text like "play"
• Create a client
• Handle exit properly - currently threads can be locking
• Use discovery method instead of fixed IP

Functionality coverage

• v1.0
  • Set basic playback status: play, pause, stop, next, prev
  • Play a Favorite
  • Calculate state - But this is not use in HA
  • Make it work with Home Assistant
  • Publish on PyPi
• v1.1
  • Set a Voicing
• v2.0
  • Retrieve basic playback status: play, pause, stop, next, prev
  • Set volume
  • Retrieve volume
  • Set to immediate standby
  • Retrieve and set Voicing
  • Retrieve current firmware, IP, serial number
  • Retrieve actual speaker state (approximately)
• v3.0
  • Make the module async

Other functionalities:

• Current Playback info
  • Retrieve current playback source
  • Retrieve current title
  • 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
  • Set a Favorite
• Extended current playback info
  • Set extended playback status: shuffle, repeat
  • Retrieve extended playback status: shuffle, repeat
  • Set Source
  • Retrieve current source
• Speaker configuration
  • Retrieve speaker name
  • Retrieve speaker color
  • Set speaker name
  • Set speaker color
  • Retrieve current IP, serial number
  • Retrieve current battery and AC information
• Network
  • Retrieve current wifi information
  • Set wifi information
• Multi-room
  • Implement SoundSpace Link

Acknowledgment

This work is based on the following:

• The Libratone command list is coming from this work from Benjamin Hanke
• A lot of further work is based on APK decompilation
• 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
  • Async and simple: anthemav integration with this module

License

See LICENSE file