# Busch-Radio Spotify Bridge

Streamt Spotify-Musik als Internetradio-Stream für das Busch-Jäger Unterputz-Internetradio.

Ein virtuelles Spotify Connect-Gerät (librespot) nimmt Audio entgegen und stellt es per Icecast als HTTP-Stream bereit.

```
Spotify-App → librespot → ffmpeg → Icecast → Busch-Jäger Radio
```

---

## Erste Einrichtung

### 1. Add-on konfigurieren und starten

Passe die Optionen an (siehe unten) und starte das Add-on.

### 2. Spotify autorisieren (einmalig)

Öffne den Einrichtungs-Assistenten im Browser:

```
http://<homeassistant-ip>:5589
```

Der Assistent führt dich Schritt für Schritt durch die Anmeldung. Die Credentials werden dauerhaft gespeichert – dieser Schritt ist nur beim ersten Start nötig.

### 3. Stream-URL im Radio eintragen

```
http://<homeassistant-ip>:8000/stream
```

### 4. Musik abspielen

Wähle in der Spotify-App **„Busch-Radio"** (oder deinen konfigurierten Gerätenamen) als Abspielgerät aus.

---

## Konfigurationsoptionen

| Option | Standard | Beschreibung |
|---|---|---|
| `device_name` | `Busch-Radio` | Name des Geräts in der Spotify-App |
| `bitrate` | `160` | Audioqualität in kbps (`96` / `128` / `160` / `192`) |
| `stream_format` | `mp3` | Audioformat (`mp3` oder `aac`) |
| `stream_port` | `8000` | HTTP-Port des Icecast-Streams |
| `stream_mount` | `/stream` | URL-Pfad des Streams |
| `icecast_password` | – | Internes Icecast-Passwort (bitte ändern) |

---

## Nützliche URLs

| URL | Funktion |
|---|---|
| `http://<ha-ip>:5589` | Einrichtungs-Assistent (OAuth) |
| `http://<ha-ip>:8000/stream` | Stream-URL für das Radio |
| `http://<ha-ip>:8000` | Icecast-Statusseite |

---

## Fehlerbehebung

**„Busch-Radio" erscheint nicht in der Spotify-App**
→ Spotify-Autorisierung noch nicht abgeschlossen. Einrichtungs-Seite öffnen: `http://<ha-ip>:5589`

**Stream nicht erreichbar**
→ Icecast-Statusseite prüfen: `http://<ha-ip>:8000`
→ Port 8000 muss im Netzwerk erreichbar sein (`host_network: true` ist aktiviert)

**Stream bricht bei Pause ab**
→ Add-on auf Version 1.0.11 oder neuer aktualisieren

**Songs wechseln zu schnell / keine Steuerung vom Handy**
→ Add-on auf Version 1.0.10 oder neuer aktualisieren

**Neu autorisieren**
→ Add-on stoppen → Datei `/data/librespot-cache/credentials.json` löschen → Add-on starten → Einrichtungs-Seite öffnen

---

## Technische Hinweise

- librespot wird beim Build aus dem Quellcode kompiliert (Rust) – der erste Build dauert ca. 10–15 Minuten
- Der OAuth-Callback-Server bindet an `0.0.0.0`, damit er aus dem Heimnetz erreichbar ist
- Audio wird nicht gespeichert – ausschließlich live gestreamt
- Spotify Premium ist für Spotify Connect erforderlich
