pykef 1.3.0

A python implementation to interface Kef speakers over tcp/ip

Python interface to control KEF speakers

Supported: KEF LS50 Wireless (Requires firmware June 2018 or later)

Untested: KEF LSX

Features supported

• Get and set volume
• Mute and Unmute
• Get and set source input
• Get if the speakers are online
• Automatically connects and disconnects when speakers goes online/offline
• Turn off speaker

Features unfortunatly unsupported

• Turn on is impossible over tcp/ip because the speaker turns off network interface when turned off. This is true for LS50 Wireless. LSX should be possible to turn on.

Note: One workaround to turning on is to use IR commands to turn on. I have included a lirc config with all the keys on the remote. Note that each command has to be sent twice to work (at least for me).

Install

pip install pykef

Discussion

See home assistant thread

Examples

Setup:

host = '192.168.1.200'
port = 50001
speaker = KefSpeaker(host, port)

Set volume:

speaker.volume = 0.5 # %50 vol

Get volume:

volume = speaker.volume

Set source:

speaker.source = InputSource.AUX

Get source:

source = speaker.source

Mute:

speaker.volume = None
# Or
speaker.muted = True

Unmute (set to volume before mute):

speaker.muted = False

Step volume up

speaker.increseVolume() # 5% increase
speaker.increseVolume(0.10) # 10% increase

Step volume down

speaker.decreaseVolume() # 5% increase
speaker.decreaseVolume(0.10) # 10% increase

Turn off

speaker.turnOff()

How to

Upload new release:

1. Update needed tools:

python3 -m pip install --user --upgrade setuptools wheel

2. Build

python3 setup.py sdist bdist_wheel

3. Upload (test)

twine upload --repository-url https://test.pypi.org/legacy/ dist/*

License

MIT License

Authors

• Robin Grönberg