samuelspagl / ha_samsung_soundbar

YASSI (Yet another Samsung Soundbar integration) is a HomeAssistant integration for Samsung Soundbars.
https://ha-samsung-soundbar.vercel.app
MIT License
42 stars 2 forks source link
homeassistant homeassistant-custom-component homeassistant-integration samsung soundbar

YASSI: Yet Another Samsung Soundbar Integration (for Home Assistant)

Welcome to YASSI, the Home Assistant integration designed to bring comprehensive control over your Samsung Soundbar into your smart home ecosystem.

[!NOTE] Please use service calls for setting the attribute of a custom capability instead of the entity. (See #43 for more information)

Table of Contents:

Why YASSI

The current Samsung Soundbar Integration by @PiotrMachowski / @thierryBourbon are already pretty cool. But I wanted it to appear as a device, and base the Foundation on the pysmartthings python package.

Additionally, I wanted full control over the Soundmode and more. So I tried out a few things with the API, and found that also the Subwoofer as well as the Equalizer are controllable.

I created a new wrapper around the pysmartthings.DeviceEntity specifically set up for a Soundbar, and this is the Result.

I hope to integrate also controls for surround speaker as well as Space-Fit Sound, but as these features are not documented... ;)

Features

For the full feature list per entity type, please take a look at the documentation website.

Installation / Setup

Prerequisites

Before you begin, ensure you have the following:

Installation

  1. Add this repository as a custom repository in HACS or manually copy the samsung_soundbar folder to the custom_components directory in your Home Assistant configuration.

    Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

  2. Restart Home Assistant.

[!NOTE] It is planned to add it to the default HACS repository list, but not done yet.

Configuration

To integrate your Samsung Soundbar with Home Assistant using YASSI, you will be asked for the following variables:

Support

For support, feature requests, or bug reporting, please visit the Issues section of this GitHub repository.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

General Thanks