ha_samsung_soundbar/docs/content/1.first-things-first/1.getting-started.md

# 🚀 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':
[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](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.
::