Spotify einrichten

Spotify Web API Setup

Verbinde deine Wundio Box mit deinem Spotify-Account. Keine Cloud-Pflicht – du nutzt deine eigene Developer App.

Wie funktioniert der Relay?

Die Autorisierung läuft über wundio.dev/spotify-callback als sicheres HTTPS-Relay. Spotify akzeptiert keine lokalen HTTP-Adressen — der Relay leitet nur den temporären Code zurück zu deiner Box. Deine Credentials verlassen deinen Browser nicht.
1

Spotify Developer App erstellen

Gehe zu developer.spotify.com/dashboard und klicke auf "Create app". Fülle die Felder so aus:

App nameWundio (beliebig)
DescriptionHome music box (beliebig)
APIs usedWeb API

Redirect URI — exakt so eintragen:

→https://wundio.dev/spotify-callback

HTTPS – wird von Spotify akzeptiert. Keine IP-Adresse nötig.

4

Erstverbindung herstellen (einmalig)

Wundio nutzt Spotify Connect – dasselbe Protokoll wie Bluetooth-Lautsprecher oder Smart-TVs. Beim ersten Start muss die Box einmalig als Wiedergabegerät ausgewählt werden, damit Spotify sie kennt.

Einmalige Erstverbindung

→
Spotify-App öffnen: Auf dem Handy oder Computer
→
Gerät auswählen: Symbol unten rechts → "Wundio" antippen
→
Fertig!: Ab sofort startet jeder RFID-Chip die Wiedergabe automatisch auf Wundio

Warum ist das nötig?

Spotify Connect-Geräte müssen einmalig vom Account-Inhaber autorisiert werden. Das ist ein Sicherheitsmerkmal von Spotify – kein Gerät kann ohne deine Zustimmung die Wiedergabe übernehmen. Nach der ersten Verbindung merkt sich Spotify die Box dauerhaft.

Nach einem Neustart

Nach dem ersten Neustart der Box ist kein weiterer manueller Schritt nötig – Wundio verbindet sich automatisch, sobald ein RFID-Tag aufgelegt wird. Nur nach einer kompletten Neuinstallation muss die Erstverbindung wiederholt werden.

Troubleshooting

❌ redirect_uri: Insecure

Ursache: Noch eine alte http://192.168.x.x:... URI in der Spotify App eingetragen.

Lösung: Ersetzen durch: https://wundio.dev/spotify-callback

❌ redirect_uri: Not matching configuration

Ursache: URI stimmt nicht exakt überein (z.B. Trailing-Slash oder Tippfehler).

Lösung: Exakt eintragen (ohne Slash am Ende): https://wundio.dev/spotify-callback

❌ Relay leitet nicht zurück zur Box

Ursache: Die IP der Box hat sich geändert (DHCP-Wechsel).

Lösung: Einstellungen öffnen → Schritt 1 im Spotify-Guide → IP neu bestätigen.

❌ Invalid client

Ursache: Client ID oder Secret falsch kopiert.

Lösung: Im Spotify Dashboard prüfen und in Wundio-Einstellungen neu eintragen.

❌ Wiedergabe startet auf dem falschen Gerät

Ursache: Wundio wurde noch nicht als Spotify Connect Gerät ausgewählt.

Lösung: Spotify-App öffnen → Gerät auswählen → Wundio antippen. Einmalig nötig.