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

cacedo/Home-Assistant-Samsung-Soundbar