Bang & Olufsen
The Bang & Olufsen integration enables control of some of the features of certain Bang & Olufsen
Compatible devices
Devices that have been tested and should work without any trouble are:
- Beoconnect Core
- Beolab 8
- Beolab 28
- Beosound 2 3rd gen
- Beosound A5
- Beosound A9 5th gen
- Beosound Balance
- Beosound Emerge
- Beosound Level
- Beosound Theatre
and any other Mozart based products.
Configuration
To add the Bang & Olufsen device to your Home Assistant instance, use this My button:
Bang & Olufsen 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.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Bang & Olufsen.
-
Follow the instructions on screen to complete the setup.
The IP address of your device. Can be found by navigating to the device on the Bang & Olufsen appSettings
→ About
→ IP address
.
Actions
play_media actions
The Bang & Olufsen integration supports different playback types in the media_player.play_media
action: playback from URL, activating a favorite, playback from a local file, playing a radio station, activating a Deezer flow and Deezer playlists, albums, tracks, and playing files and text-to-speech (TTS) as an overlay.
play_media examples
Playing DR P1
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: url
media_content_id: http://live-icy.dr.dk/A/A03H.mp3
Activating the first favourite:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: favourite
media_content_id: 1
Playing a local file:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_id: media-source://media_source/local/example.mp3
media_content_type: music
Playing a radio station:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_id: 1234567890123456
media_content_type: radio
Playing a Deezer flow. Optionally define a Deezer user ID:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: deezer
media_content_id: flow
extra:
id: 1234567890
Playing a Deezer playlist. Optionally define starting position for the playlist:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: deezer
media_content_id: playlist:1234567890
extra:
start_from: 123
Playing a Deezer album. Optionally define starting position for the album:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: deezer
media_content_id: album:1234567890
extra:
start_from: 123
Playing a Deezer track:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: deezer
media_content_id: 1234567890
Playing a Tidal playlist. Optionally define starting position for the playlist:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: tidal
media_content_id: playlist:01234567-89ab-cdfe-0123-456789abcdef
extra:
start_from: 123
Playing a Tidal album. Optionally define starting position for the album:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: tidal
media_content_id: album:123456789
extra:
start_from: 123
Playing a Tidal track:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: tidal
media_content_id: 123456789
Overlay
Interrupts currently playing media to play an audio message.
To use the Bang & Olufsen Cloud TTS, use overlay_tts
as the media_content_type
and enter a message into the media_content_id
field.
Bang & Olufsen Cloud TTS messages are limited to 100 unique messages a day and are cached for 24 hours.
Extra keys available:
Data attribute | Optional | Description |
---|---|---|
overlay_absolute_volume |
yes | Specify an absolute volume for the overlay. |
overlay_offset_volume |
yes | Specify a volume offset to be added to the current volume level. |
overlay_tts_language |
yes | Specify the language used for text-to-speech. Uses the BCP 47 standard. Default value is “en-us”. |
Examples:
Playing a local file with an absolute volume as an overlay:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: music
media_content_id: media-source://media_source/local/doorbell.mp3
announce: true
extra:
overlay_absolute_volume: 60
Playing a Bang & Olufsen Cloud TTS message with an offset volume (as TTS messages can be quiet):
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: overlay_tts
media_content_id: This is a test
announce: true
extra:
overlay_offset_volume: 10
Playing a Bang & Olufsen Cloud TTS message with a local language:
action: media_player.play_media
target:
entity_id: media_player.beosound_balance_12345678
data:
media_content_type: overlay_tts
media_content_id: Dette er en test
announce: true
extra:
overlay_tts_language: da-dk
Automations
WebSocket notifications received from the device are fired as events in Home Assistant. These can be received by listening to bang_olufsen_websocket_event
event types, where device_id
or serial_number
can be used to differentiate devices.
Getting Deezer URIs
To find Deezer playlist, album URIs, and user IDs for Deezer flows, the Deezer website has to be accessed. When navigating to an album, the URL will look something like: https://www.deezer.com/en/album/ALBUM_IDalbum:ALBUM_ID
and the same applies to playlists, which have the format: playlist:PLAYLIST_ID
.
Additionally a Deezer user ID can be found at https://www.deezer.com/en/profile/USER_ID
Getting Tidal URIs
Tidal playlists, album URIs and track IDs are available via the Tidal website. When navigating to an album, the URL will look something like https://listen.tidal.com/album/ALBUM_ID/album:ALBUM_ID
. The same applies to playlists, which have the format playlist:PLAYLIST_ID
. Individual tracks can be found by sharing the track and selecting the Copy track link
method, which should yield a link of the format https://tidal.com/browse/track/TRACK_ID?uTRACK_ID
.