Home-Assistant-custom-components-SmartThings-Soundbar
Home-Assistant-custom-components-SmartThings-Soundbar copied to clipboard
Samsung Smarthings API for controlling Soundbar
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 |
|
![]() |
|
buycoffee.to |
|
|
|
PayPal |
|
![]() |
|
Revolut |
|
![]() |
|