Skip to content

mimale/Home-Assistant-custom-components-SmartThings-Soundbar

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

70 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HACS Custom GitHub Latest Release GitHub All Releases Buy me a coffee PayPal.Me

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 yout SmartThings account.

Obtain an API key from https://account.smartthings.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.smartthings.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/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-Q800T
  • Samsung HW-Q950T
  • Samsung HW-Q990B
  • Samsung HW-Q90R
  • Samsung HW-Q80R
  • Samsung HW-Q70R
  • Samsung HW-S60T
  • Samsung HW-S61T

Buy Me A Coffee PayPal Logo

About

Samsung Smarthings API for controlling Soundbar

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%