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

Samsung Smarthings API for controlling Soundbar
MIT License
92 stars 24 forks source link
samsung soundbar

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

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:

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

Supported devices

This integration was confirmed to work with following devices:

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