Skip to content

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

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

61 Commits
 
 
 
 
 
 

Repository files navigation

SmartThings Soundbar

hacs_badge buymeacoffee_badge paypalme_badge

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

Download media_player.py, api.py, and manifest.json 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/raw/master/custom_components/smartthings_soundbar/media_player.py
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-SmartThings-Soundbar/raw/master/custom_components/smartthings_soundbar/api.py
wget https://github.com/PiotrMachowski/Home-Assistant-custom-components-SmartThings-Soundbar/raw/master/custom_components/smartthings_soundbar/manifest.json

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-Q90R
  • Samsung HW-Q80R
  • Samsung HW-Q70R

Buy Me A Coffee

About

Samsung Smarthings API for controlling Soundbar

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%