Skip to content

ThierryBourbon/Home-Assistant-Samsung-Soundbar

This branch is 58 commits ahead of mimale/Home-Assistant-custom-components-SmartThings-Soundbar:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

author
Thierry Bourbon
Jun 24, 2023
e38b35a · Jun 24, 2023
Jun 23, 2023
Jun 18, 2023
Jun 24, 2023
Jan 24, 2022
Jun 23, 2023
Jun 21, 2023

Repository files navigation

HACS Custom GitHub Latest Release GitHub All Releases Buy me a coffee

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

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:

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

Packages

No packages published

Languages

  • Python 100.0%