Bluesound

The bluesound platform allows you to control your Bluesound HiFi wireless speakers and audio integrations from Home Assistant.

Configuration

To add the Bluesound integration to your Home Assistant instance, use this My button:

Bluesound can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Bluesound.

  • Follow the instructions on screen to complete the setup.

Action bluesound.join

Group players together under a single master speaker. That will make a new group or join an existing group.

Data attribute Optional Description
master no A single entity_id that will become/hold the master speaker.
entity_id no String or list of a single entity_id that will group to master speaker.

Action bluesound.unjoin

Remove one or more speakers from a group of speakers. If no entity_id is provided, all speakers are unjoined.

Data attribute Optional Description
entity_id yes String or list of entity_ids that will be separated from their master speaker.

Action bluesound.set_sleep_timer

Sets a timer that will turn off the speaker. For each time you call this it will increase the time by one step. The steps are (in minutes): 15, 30, 45, 60, 90, 0. If you increase an ongoing timer of for example 13 minutes, it will increase it to 15. If the timer is set to 90, it will remove the time (hence the 0).

Data attribute Optional Description
entity_id no String or list of entity_ids that will have their timers set.

Action bluesound.clear_sleep_timer

Clear the sleep timer on a speaker, if one is set.

Data attribute Optional Description
entity_id no String or list of entity_ids that will have their timers cleared.