samsung Soundbar

Adds support for samsung enabled Soundbar

Features

• Turn on/off
• Set volume
• Step volume up/down
• Mute/unmute
• Select source
• Select soundmode
• Show current volume level
• Show current state: on/off/playing/paused/idle
• Show if muted/unmuted
• Show current source
• Extra switchs: Voice_amplifier, Bass Boost, Night Mode

Configuration options

Key	Type	Required	Default	Description
name	string	False	samsung Soundbar	Name of soundbar
api_key	string	True	-	samsung API key (see:here)
device_id	string	True	-	samsung device id (see:here)
max_volume	positive integer	False	100	Volume level that will be used as a maximum level in Home Assistant

Examples usage

samsung_soundbar:
  devices:
    - name: Barre de son
      api_key: b13391c7-8cef-4518-a58e-393b0xxxxxxx
      device_id: da93855b-45cd-6ca0-86d6-2c957xxxxxx
      max_volume: 100

If you want you can customise switch names to your language

homeassistant:
  customize:
    switch.barre_de_son_night_mode:
      friendly_name: "Mode Nuit"
    switch.barre_de_son_bass_boost:
      friendly_name: "Amélioration des Basses"
    switch.barre_de_son_voice_amplifier:
      friendly_name: "Amélioration Vocale"

Device

this integration creates a device composed of a media player and 3 switches

• bass_boost
• Night_mode
• voice_amplifier

You can group them on an entities card

Getting API key and device id

Make sure your device is connected to yout samsung account.

Obtain an API key from https://account.samsung.com/tokens

Go here for your device id for each device. Click on the name of your device and the device id will be in the URL

https://graph-eu01-euwest1.api.samsung.com/device/show/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX

Installation

Using HACS (recommended)

This integration can be added to HACS as a custom repository:

• URL: `https://github.com/ThierryBourbon/Home-Assistant-Samsung-Soundbar
• Category: Integration

Manual

To install this integration manually you have to download samsung_soundbar.zip and extract its contents to config/custom_components/samsung_soundbar directory:

mkdir -p custom_components/samsung_soundbar
cd custom_components/samsung_soundbar
wget https://github.com/ThierryBourbon/Home-Assistant-custom-components-samsung-Soundbar/blob/master/samsung_soundbar.zip
unzip samsung_soundbar.zip
rm samsung_soundbar.zip

Known problems

• If you have config validation issues after installing this component you have to follow these steps:
  • Install custom component
  • Restart Home Assistant
  • Add configuration
  • Restart Home Assistant again

Supported devices

This integration was confirmed to work with following devices:

• Samsung HW-N950
• Samsung HW-Q800T
• Samsung HW-Q950T
• Samsung HW-Q990B
• Samsung HW-Q90R
• Samsung HW-Q80R
• Samsung HW-Q70R
• Samsung HW-S60T
• Samsung HW-S61T
• Samsung HW-Q930B