-
-
Notifications
You must be signed in to change notification settings - Fork 3
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into fix/division-by-zero
# Conflicts: # CHANGELOG.md # custom_components/samsung_soundbar/manifest.json
- Loading branch information
Showing
9 changed files
with
220 additions
and
134 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
13 changes: 13 additions & 0 deletions
13
docs/content/1.first-things-first/0.why-another-integration.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| # ❓ Why another integration | ||
|
|
||
| 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... ;) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,43 @@ | ||
| # 🚀 Getting Started with Yassi | ||
|
|
||
| Welcome to Yassi, the HomeAssistant integration for your Samsung Soundbar. This guide will help you get up and running in no time. | ||
|
|
||
| ## 📦 Installation Options | ||
|
|
||
| ### HACS (Home Assistant Community Store) | ||
|
|
||
| #### 🌟 Official Repository (Coming Soon) | ||
| The Yassi integration will be available through the official HACS repository shortly. Stay tuned for updates. | ||
|
|
||
| #### ➕ Custom Repository | ||
| In the meantime, you can manually add this repository to HACS: | ||
| 1. Click the following button and 'open link': | ||
| [](https://my.home-assistant.io/redirect/hacs_repository/?owner=samuelspagl&repository=ha_samsung_soundbar&category=integration) | ||
| 2. Click 'add' to add the custom repository. | ||
| 3. Download 'Yassi' and restart Home Assistant. | ||
|
|
||
| ### 📂 Manual Installation | ||
| If you prefer to install Yassi manually: | ||
| 1. Download the latest release from the repository. | ||
| 2. Extract and copy the `custom_components/samsung_soundbar` folder. | ||
| 3. Paste it into the `config/custom_components/samsung_soundbar` directory of your HomeAssistant setup. | ||
|
|
||
| ## ⚙️ Configuration Steps | ||
|
|
||
| Once Yassi is installed, you can configure it via the HomeAssistant UI: | ||
|
|
||
| 1. Go to 'Configuration' and then 'Integrations'. | ||
| 2. Click on 'Add Integration' and search for 'Yassi'. | ||
| 3. Enter the following details to complete the setup: | ||
| - 🔑 SmartThings API Key: [Obtain it here](https://account.smartthings.com/tokens). | ||
| - 🆔 Device ID: [Find your Soundbar's device ID here](https://my.smartthings.com/advanced/devices). | ||
| - ㍻ Soundbar Name: Choose a name for easy identification. | ||
| - 🔊 Max Volume: Set the maximum volume limit for your Soundbar. | ||
|
|
||
| Follow these steps, and you'll be enjoying seamless control over your Samsung Soundbar with Yassi in no time! | ||
|
|
||
| ::alert{type="info"} | ||
| The `🔊 Max Volume` setting will readjust the internal values of the `media_player` entity from 0-100 to 0-MaxVolume. | ||
| Therefore will the slider not display the same value as the one provided by the `sensor` entity, which will always display | ||
| the raw value retrieved from the SmartThings API. | ||
| :: |
17 changes: 17 additions & 0 deletions
17
docs/content/1.first-things-first/2.issues-and-other-things.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,17 @@ | ||
| # ‼️ Issues and other things | ||
|
|
||
| As the creator of this personal and fun project, I am thrilled to see people using it. While I won’t always have immediate availability to address every request, I’ll do my best to fix issues and implement features. Thanks a lot in advance! 🙌 | ||
|
|
||
| Here are some best practices to help me help you: | ||
|
|
||
| 1. 🐞 GitHub Issues: For any issues or bugs, please submit them via GitHub Issues. ([🔗 click here](https://github.com/samuelspagl/ha_samsung_soundbar/issues/new)) | ||
| 2. 📋 Provide Details: Include essential information: | ||
| - Home Assistant OS Version | ||
| - Samsung Soundbar Model | ||
| - Other Relevant Details (like debug logs) | ||
| 3. 🎇 Icons for Fun: | ||
| - 📦 = Feature Request | ||
| - 🐛 = Bug Report | ||
| - ❓ = General Questions | ||
|
|
||
| Let’s collaborate to enhance your soundbar experience! 🎶🔊 |
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.