README.md

SmartThings Soundbar

Adds support for SmartThings enabled Soundbar

Features

• Turn on/off
• Set volume
• Step volume up/down
• Mute/unmute
• Select source
• Show current volume level
• Show current state: on/off/playing/paused/idle
• Show if muted/unmuted
• Show current source

Configuration options

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

Example usage

media_player:
  - platform: smartthings_soundbar
    name: Soundbar
    api_key: "YOUR API KEY"
    device_id: "YOUR DEVICE ID"
    max_volume: 30

Getting API key and device id

Make sure your device is connected to your SmartThings account.

Obtain an API key by following these steps.

Once you're signed in on that page, go to https://api.smartthings.com/v1/devices to see a list of your devices and their device IDs.

Installation

Using HACS (recommended)

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

• URL: https://github.com/PiotrMachowski/Home-Assistant-custom-components-SmartThings-Soundbar
• Category: Integration

After adding a custom repository you can use HACS to install this integration using user interface.

Manual

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

mkdir -p custom_components/smartthings_soundbar
cd custom_components/smartthings_soundbar
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-SmartThings-Soundbar/releases/latest/download/smartthings_soundbar.zip
unzip smartthings_soundbar.zip
rm smartthings_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-Q800B
• Samsung HW-Q800T
• Samsung HW-Q950T
• Samsung HW-Q990B
• Samsung HW-Q990C
• Samsung HW-Q90R
• Samsung HW-Q80R
• Samsung HW-Q70R
• Samsung HW-S60T
• Samsung HW-S61T

Support

If you want to support my work with a donation you can use one of the following platforms:

Platform	Payment methods	Link	Comment
Ko-fi	PayPal Credit card		No fees Single or monthly payment
buycoffee.to	BLIK Bank transfer
PayPal	PayPal		No fees
Revolut	Revolut Credit Card		No fees