Skip to content

Latest commit

 

History

History
403 lines (308 loc) · 12.8 KB

README.md

File metadata and controls

403 lines (308 loc) · 12.8 KB
Raw

Home Assistant integration for Bang & Olufsen products

hacs_badge

Balance stereo

This integration enables control of some of the features of a Bang & Olufsen device through Home Assistant.

This integration uses the Mozart open API

Compatible devices

Devices that have been tested and should work without any trouble are:

Configuration

This device can be added to your Home Assistant installation manually by using the UI or by auto-discovery.

Entities

This integration adds an array of different useful entities that are generated and added automatically upon setup, customized for the supported features of the device.

SUPPORTS_PROXIMITY_SENSOR = (
    "BeoLab 28",
    "Beosound Balance",
    "Beosound Level",
    "Beosound Theatre",
)

Media Player entity

  • Playback control: play/pause/stop/previous/next
  • Adjust volume: set volume/step volume/mute
  • Clear playlist
  • Enable shuffle / repeat
  • Select playback source
  • Display artwork from currently playing music
  • Displaying currently playing artist and track
  • Displaying playback progress
  • Media seeking (Currently only when using Deezer)
  • Device triggers for automations by using device buttons such as Preset1, Bluetooth etc.
  • Device triggers for automations by using the Beoremote One Control and Light events
  • Events fired upon WebSocket events received
  • Media browsing:
    • Playback of local media
    • Radio Browsing
    • TTS
  • Displaying various extra state attributes
    • Beolink:
      • Own JID
      • Beolink leader (if available)
      • Beolink listeners (if available)
      • Beolink peers (if available)
    • Bluetooth devices:
      • Currently connected bluetooth devices such as phones (if available)
      • Paired remotes (if available)
  • Using the play_media service:
    • Activate a favourite
    • Play from a URI
    • Play a local file
    • Play a radio station
    • Play a Deezer flow
    • Play an album from Deezer (with optional starting position)
    • Play a playlist from Deezer (with optional starting position)
    • Play a track from Deezer
  • Custom services:
    • Overlay
      • overlay_audio: Overlaying audio over any currently playing audio.
    • Beolink:
      • beolink_allstandby: Set all connected Beolink devices to standby
      • beolink_expand: Expand the Beolink experience with a device
      • beolink_join: Join a Beolink experience, either with specific JID or automatically
      • beolink_leave: Leave a Beolink experience
      • beolink_unexpand: Unexpand a device from a Beolink experience
      • beolink_set_volume: Set volume level on all devices in the Beolink experience
      • beolink_leader_command: Run media_player commands on the Beolink leader from anywhere in the experience:
        • set_volume_level
        • media_seek
        • mute_volume
        • select_source
        • turn_on
        • turn_off
        • volume_up
        • volume_down
        • media_play_pause
        • media_pause
        • media_play
        • media_stop
        • media_next_track
        • media_previous_track
        • toggle

Some entities are added according to lists of supported devices. These are currently:

Binary Sensor entity

  • Battery Charging (If available)
  • Proximity sensor (If available)

Button entity

  • Favourite entities

Number entity

  • Treble
  • Bass

Sensor entity

  • Battery Level (If available)
  • Battery Charging Time (If available)
  • Battery Playing Time (If available)

Select entity

  • Sound mode (If available)

Switch entity

  • Loudness

Text entity

  • Media ID (If available)

Getting Deezer URIs

In order 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_ID", and this simply needs to be converted to: album:ALBUM_ID and the same applies to playlist, which have the format: playlist:PLAYLIST_ID.

Additionally a Deezer user ID can be found at https://www.deezer.com/en/profile/USER_ID by selecting the active user in a web browser.

Deezer track IDs can currently only easily be found by playing the track on the device and looking at the extra state attributes, where it is shown with the key "deezer_track_id". Tracks do not have a prefix so the ID needs to be used directly.

Automations

All device triggers can be received by listinging to bangolufsen_event event types.

Additionally the "raw" WebSocket notifications received from the device are fired as events in Home Assistant. These can be received by listening to bangolufsen_websocket_event event types.

Physical buttons and sensors

The "shortPress" of all the buttons, except for volume control, are available as device triggers.

If the device has a proximity sensor, then a proximity sensor binary sensor will be available in Home Assistant.

Beoremote One

Device triggers for the Beoremote One are supported and will be available once the integration detects that it has been paired with the device. To trigger these triggers, enter the "Control" or "Light" submenu, and press any of the compatible buttons. Each button press will send a "press" and a "release" event and therefore also a "press" and a "release" device trigger.

The favourite buttons correspond to the physical favourite buttons on the device.

Automation examples

Using the overlay as doorbell

description: Play doorbell sound overlay on doorbell press.
mode: single
trigger:
  - platform: device
    device_id: 1234567890abcdef1234567890abcdef
    domain: example
    type: doorbell
condition: []
action:
  - service: bangolufsen.overlay_audio
    data:
      uri: media-source://media_source/local/doorbell.mp3
      absolute_volume: 60
    target:
      entity_id: media_player.beosound_balance_12345678

Using the overlay TTS as a bedtime reminder

description: "Daily bedtime reminder using overlay TTS."
mode: single
trigger:
  - platform: time
    at: "22:00:00"
condition: []
action:
  - service: bangolufsen.overlay_audio
    data:
      absolute_volume: 70
      tts: It is 22:00. Time to go to bed!
    target:
      entity_id: media_player.beosound_balance_12345678

Using the Beoremote One to control lights

description: Use the Beoremote One to control living room lights.
mode: single
trigger:
  - platform: device
    device_id: 234567890abcdef1234567890abcdef1
    domain: bangolufsen
    type: Light/Digit1_KeyPress
condition: []
action:
  - service: light.toggle
    target:
      entity_id: light.living_room

Setting all devices to standby when leaving home

description: Set all Bang & Olufsen devices to standby when leaving home.
mode: single
trigger:
  - platform: zone
    entity_id: person.example
    zone: zone.home
    event: leave
condition: []
action:
  - service: bangolufsen.beolink_allstandby
    data: {}
    target:
      entity_id: media_player.beosound_balance_32836899

Services

play_media services

The Bang & Olufsen integration supports different playback types in the media_player.play_media service: playback from URL, activating a favourite, playback from a local file, playing a radio station, activating a Deezer flow and Deezer playlists, albums and tracks.

play_media examples

Playing DR P1 from a URL:

service: 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:

service: 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:

service: 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:

service: 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:

service: media_player.play_media
target:
  entity_id: media_player.bangolufsen
data:
  media_content_type: deezer
  media_content_id: flow
  extra:
    id: 1234567890

Playing a Deezer playlist. Optionally define starting position for the playlist:

service: 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:

service: 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:

service: media_player.play_media
target:
  entity_id: media_player.beosound_balance_12345678
data:
  media_content_type: deezer
  media_content_id: 1234567890

Custom services

The Bang & Olufsen integration additionally supports different custom services

Service bangolufsen.beolink_join

Join a Beolink experience.

Service data attribute Optional Description
beolink_jid yes Manually specify Beolink JID to join.

Service bangolufsen.beolink_expand

Expand current Beolink experience.

Service data attribute Optional Description
beolink_jids no Specify which Beolink JIDs will join current Beolink experience.

Service bangolufsen.beolink_unexpand

Unexpand from current Beolink experience.

Service data attribute Optional Description
beolink_jids no Specify which Beolink JIDs will leave from current Beolink experience.

Service bangolufsen.beolink_leave

Leave a Beolink experience.

Service bangolufsen.beolink_allstandby

Set all Connected Beolink devices to standby.

Service bangolufsen.beolink_set_volume

Set a volume level for all connected Beolink devices.

Service data attribute Optional Description
volume_level no Specify the volume level.

Service bangolufsen.beolink_leader_command

Send a media_player command to Beolink leader.

Service data attribute Optional Description
command no Specify the media_player command.
parameter yes Specify the media_player command's parameter.

Service bangolufsen.overlay_audio

Overlay audio over any currently playing audio. TTS is generated by Bang & Olufsen and is limited to 100 unique messages a day. Generated TTS messages are cached for 24 hours.

Service data attribute Optional Description
uri yes Specify the audio to play.
absolute_volume yes Specify an absolute volume for the overlay.
volume_offset yes Specify a volume offset to be added to the current volume level.
tts yes Specify a string to be converted to a TTS message.
tts_language yes Specify TTS language.