Skip to content

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

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

82 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HACS Custom GitHub Latest Release GitHub All Releases Ko-Fi buycoffee.to PayPal.Me Revolut.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 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
  • Buy Me a Coffee at ko-fi.com
  • No fees
  • Single or monthly payment
  • buycoffee.to
  • BLIK
  • Bank transfer
  • Postaw mi kawę na buycoffee.to
    PayPal
  • PayPal
  • PayPal Logo
  • No fees
  • Revolut
  • Revolut
  • Credit Card
  • Revolut
  • No fees