This custom component is available on HACS !
You can also install it manually, but HACS is the recommended method (see bellow for "manual installation").
Installation with HACS\
Go to your Home Assistant instance > HACS tab > Integrations.
Clic on explore & download repository on the bottom right corner.
Search for Kef Connector.
Clic on Kef Connector > then "Download this repository with HACS" > then Download
Now, restart home assistant and then follow the instructions in the configuration section.
Manual Installation
Copy the kef_connector folder in your home assistant config/custom_components folder, and then follow the configuration section.
π§ Configuration
In your configuration.yaml file, add the following :
β οΈReplace<IP-of-your-speakers>with the correct IP.
More information on how to find the IP of your Kef speakers here.
π Platform configuration options
Here is the list of the variables you can set if your configuration.yaml file.
option
required
default value
comment
host
Required
None
This should be a string in the form www.xxx.yyy.zzz, being the IP address of your speakers.
name
Optional
see comment
If you do not specify a name, the integration will fetch the name you set up on the KefConnect app for your speakers, if any. If you specify a name property, this name will be used instead.
maximum_volume
Optional
1.0
This should be a float between 0 and 1. 0 is muted and 1 is maximum volume. Bear in mind that this option does not override the maximum volume set in the KefConnect app. It will prevent hass from setting a volume higher than maximum_volume
volume_step
Optional
0.03
This should be float bewteen 0 and 1 (however it is not recommended to set it higher than 0.1). This value is by how much volume will be changed when calling media_player.volume_up or media_player.volume_down services, by clicking on for example.
speaker_model
Optional
see comment
Write the model of your KEF speakers (either LSX2, LSX2LT, LS50W2 or LS60). This allows Kef Connector to know which sources are available on your speakers. If you do not put speaker_model in your configuration.yaml, by default, all sources will be available on the entity, even though they are not physically present on your speakers (for example, there is no analog input on the LSX2LT).
π§βπ¬ Full configuration example
This is just and example ! You can copy it but at least change the host value to the IP address of you speakers. More info on how to find the IP address here.