Ich wurde in den Kommentaren mehrfach gebeten, noch mal zu zeigen, was Music Assistant eigentlich ist und wie man es einrichtet. Das Ganze ist eine Oberfläche, die deine Musikquellen zusammenführt: Spotify, Apple Music, lokale Dateien auf dem NAS, Audible, Podcasts und Radio. Aus dieser einen Bibliothek spielst du auf die Lautsprecher in deinem Zuhause, auch in mehreren Räumen gleichzeitig. Über die Integration landen alle Wiedergabegeräte als Mediaplayer in Home Assistant. Dann kann eine Automation morgens deinen Radiosender starten oder um Mitternacht ein Geburtstagslied abspielen.
Hier steht die Einrichtung Schritt für Schritt. Die Details zu Spotify und Apple Music habe ich aus der Doku von Music Assistant ergänzt.
Stand November 2026: Home Assistant 2026.11.2, Music Assistant 2.10.12. Die Beschriftungen stammen aus der deutschen Oberfläche.
Was du brauchst
- Home Assistant mit Home Assistant OS. Nur dort gibt es den App-Store, aus dem du Music Assistant installierst. Für alle anderen Installationsarten gibt es ein Docker-Image, die Anleitung steht in der Doku zur Installation
- Ein 64-Bit-System mit mindestens 2 GB Arbeitsspeicher, zum Beispiel ein Raspberry Pi 4 oder neuer
- Server und Lautsprecher müssen im selben Netz hängen, ohne VLAN dazwischen. Music Assistant findet die Geräte über Multicast (mDNS und uPnP). Ein getrenntes Netz ist laut Doku der häufigste Grund, warum es nicht klappt
- Für Spotify brauchst du ein Premium-Abo (Duo und Family zählen auch). Mit einem kostenlosen Konto geht es nicht
- Bei Apple Music muss es ein bezahltes Abo sein
- Dazu kommen Lautsprecher, die Music Assistant ansteuern kann, etwa Sonos, AirPlay- oder Chromecast-Geräte. Die Liste steht in der Doku zu den Wiedergabegeräten
Die Integration in Home Assistant brauchst du nur für Automationen und Dashboards. Music Assistant läuft auch ohne sie.
Schritt 1: Music Assistant installieren
- Öffne in Home Assistant Einstellungen → Apps und klicke unten auf App installieren. Bis Home Assistant 2026.1 heißt der Bereich „Add-ons".
- Suche nach
musicund wähle Music Assistant aus. Daneben stehen noch „Music Assistant (BETA)", „Music Assistant (NIGHTLY)" und „Music Assistant DEV SERVER". Das sind Vorabversionen, in denen noch Fehler stecken können. Für den Alltag nimmst du die normale App. - Klicke auf Installieren.
Danach stellst du auf der Seite der App vier Schalter ein:
- „Beim Systemstart starten" schaltest du ein, damit Music Assistant nach einem Neustart wieder läuft
- Der Watchdog kommt ebenfalls an, dann startet die App nach einem Absturz von selbst neu
- Bei den automatischen Updates ist es Geschmackssache. Ich habe sie an, weil es eine offizielle App ist
- Mit „In Seitenleiste anzeigen" ist Music Assistant später nur einen Klick entfernt
Zum Schluss klickst du auf Starten und öffnest Music Assistant über die Seitenleiste.
Oder direkt: Music Assistant im App-Store öffnen.
Schritt 2: Die Oberfläche kennenlernen
Links steht die Seitenleiste mit Interpreten, Alben, Titel, Wiedergabelisten, Podcasts, Radio und Genres. Nach der Installation ist das alles leer. Music Assistant bringt keine eigene Musik mit, es liest aus den Quellen, die du anbindest.
Zwei Bereiche in den Einstellungen füllen die Oberfläche:
- Die Musikquellen bestimmen, woher die Musik kommt (Schritt 3)
- Über Wiedergabegeräte-Anbieter und Wiedergabegeräte legst du fest, worauf sie läuft (Schritt 6)
Schritt 3: Musikquellen hinzufügen
- Öffne in Music Assistant Einstellungen → Musikquellen.
- Klicke auf Füge eine Musikquelle hinzu.
- Wähle den Dienst aus, klicke auf Öffnen und folge der Einrichtung.
In der Liste stehen neben Spotify und Apple Music unter anderem Audible, ARD Sounds, Deezer, eine iTunes-Podcastsuche, Overcast und Pocket Casts. Was jede Quelle kann, steht in der Doku zu den Musikquellen.
Du kannst mehrere Quellen gleichzeitig anbinden. Music Assistant legt alles in eine gemeinsame Bibliothek und versucht, dasselbe Album aus verschiedenen Quellen zu einem Eintrag zu verbinden.
Spotify
Spotify verlangt ein Premium-Abo, auch für Music Assistant. Bei der Einrichtung meldest du dich mit deinem Spotify-Konto an und wählst danach, womit die Musik abgespielt wird. Die Spotify-Seite der Doku beschreibt zwei Wege:
| librespot | Spotify Soloist | |
|---|---|---|
| Was es ist | von der Community gebaut, voreingestellt | Spotifys eigene Abspielsoftware für Geräte ohne Bildschirm |
| Konten, die seit Dezember 2024 angelegt wurden | spielen meist nicht | funktionieren |
| Beste Qualität | Ogg Vorbis mit 320 kbit/s | verlustfrei bis 24 Bit und 44,1 kHz |
| Einrichtung | eine einmalige Freigabe der Wiedergabe | Bedingungen bestätigen, API-Schlüssel anlegen, koppeln |
| Start der Wiedergabe und Spulen | schnell | dauert etwas länger |
| Zwei Wiedergabegeräte gleichzeitig | geht | eines pro Spotify-Konto |
Für die Freigabe bei librespot nimmst du am besten die Spotify-App auf dem Handy. Das Handy muss dafür im selben Netz sein wie Music Assistant.
Bei Soloist erscheint Music Assistant in der Spotify-App als Gerät „Music Assistant Pairing". Du startest dort irgendeinen Titel, tippst auf das Lautsprecher-Symbol und wählst dieses Gerät aus. Die Doku weist darauf hin, dass Spotifys Bedingungen diese Nutzung von Soloist nicht eindeutig erlauben. Du nutzt es auf eigenes Risiko.
Apple Music
Apple Music braucht ein bezahltes Abo. Die Wiedergabe über Music Assistant wird von Apple nicht offiziell unterstützt, auch das läuft laut Apple-Music-Seite der Doku auf eigenes Risiko.
Bei der Einrichtung meldest du dich in einem Pop-up mit deiner Apple-ID an und gibst Music Assistant Zugriff auf deine Mediathek. Drei Dinge solltest du vorher wissen:
- Apple leitet dich nach der Anmeldung nur dann zurück, wenn du Music Assistant in diesem Moment über seine eigene Adresse geöffnet hast, also
http://<IP von Music Assistant>:8095. Bei der App in Home Assistant öffnest du Music Assistant sonst über die Seitenleiste, das reicht hier nicht. Probier die Adresse im Browser aus: Bei mir ist Port 8095 ohne weiteres Zutun erreichbar. Die Doku schreibt, dass er bei der App erst geöffnet werden muss, erklärt aber nicht, wie. Der Port selbst steht bei den Core-Einstellungen unter Webserver - Die Anmeldung läuft nach 180 Tagen ab. Dann meldest du dich von Hand neu an
- Die höchste Qualität ist AAC mit 256 kbit/s. Lossless und Dolby Atmos gibt es über Music Assistant nicht. Zwischen zwei Titeln kann eine Pause von bis zu fünf Sekunden liegen
Schritt 4: Musik suchen und abspielen
- Öffne die Suche und gib einen Begriff ein, bei mir „Bibi Blocksberg".
- Music Assistant zeigt die Treffer aus allen Quellen, die du angebunden hast. Bei jedem Treffer steht, aus welchem Dienst er kommt.
- Mit Mehr anzeigen klappst du weitere Treffer auf. Oben filterst du nach Titeln, Interpreten, Alben, Wiedergabelisten, Podcasts oder Hörbüchern.
- Klick auf einen Treffer, dann startet die Wiedergabe.
Wiedergabelisten kannst du direkt in Music Assistant anlegen.
Schritt 5: Party mit Gastzugang
Wenn Besuch da ist, können deine Gäste Musik in die Warteschlange legen, ohne dass du ihnen Zugriff auf dein Home Assistant gibst. Das erinnert an die Party-Funktion von Spotify, nur mit allen Quellen, die du angebunden hast.
- Füge das Party-Plugin hinzu: Einstellungen → Plugins → Plugin hinzufügen → Party.
- Öffne in der Seitenleiste die Party und aktiviere dort den Gastzugang. Denselben Schalter gibt es in den Einstellungen des Plugins.
- Die Party-Ansicht zeigt jetzt einen QR-Code. Deine Gäste scannen ihn mit der Handykamera und landen auf einer eigenen Seite im Browser.
- Dort suchen sie nach Titeln oder Interpreten und setzen ihre Wünsche auf die Warteschlange.
Die Gäste brauchen kein Konto und sehen nichts von deinen Einstellungen. Der QR-Code gilt in der Voreinstellung acht Stunden. In den Einstellungen des Plugins kannst du begrenzen, wie viele Wünsche jeder Gast hat. Alle Optionen stehen in der Doku zum Party-Plugin.
Schritt 6: Lautsprecher und Multiroom einrichten
Lautsprecher fügst du nicht einzeln hinzu. Du wählst unter Einstellungen → Wiedergabegeräte-Anbieter mit Füge einen Wiedergabegeräte-Anbieter hinzu den Anbieter für deine Geräteart aus, etwa Sonos oder AirPlay. Kann der Anbieter Geräte selbst finden, tauchen deine Lautsprecher danach unter Wiedergabegeräte auf. Bei manchen Anbietern trägst du die Adresse von Hand ein.
Unten im Player wählst du aus, auf welchem Gerät die Musik läuft. Dort regelst du auch Lautstärke, Play, Pause und Zufallswiedergabe.
Für Multiroom fasst du in der Liste der Wiedergabegeräte mehrere Geräte zusammen. Sie spielen dann denselben Titel gleichzeitig. Welche Geräte sich miteinander gruppieren lassen, hängt vom Hersteller und vom Protokoll ab. Die Einzelheiten stehen in der Doku zu Gruppen.
Schritt 7: Music Assistant mit Home Assistant verbinden
Bis hierhin läuft Music Assistant für sich. Die Integration holt die Wiedergabegeräte nach Home Assistant.
- Öffne Einstellungen → Geräte & Dienste.
- Meist steht Music Assistant schon unter Entdeckt. Dann fügst du es dort hinzu.
- Steht es dort nicht, klickst du unten rechts auf Integration hinzufügen, suchst nach
Music Assistantund bestätigst den Dialog.
Oder direkt: Music-Assistant-Integration einrichten.
Auf Home Assistant OS fragt der Dialog, ob die offizielle Music-Assistant-App benutzt werden soll. Ist sie noch nicht installiert, erledigt Home Assistant das an dieser Stelle. Du kannst also auch mit der Integration anfangen und Schritt 1 überspringen. Läuft dein Music Assistant woanders, etwa in einem eigenen Container, trägst du die Adresse des Servers von Hand ein.
Danach gibt es für jedes Wiedergabegerät und jede Gruppe aus Music Assistant einen Mediaplayer in Home Assistant. Bei mir sind das 20 Stück. Was die Integration alles kann, steht in der Doku von Home Assistant.
Schritt 8: Musik per Automation starten
Die Integration bringt eigene Aktionen mit: music_assistant.play_media, music_assistant.play_announcement, music_assistant.search, music_assistant.get_library, music_assistant.get_queue sowie music_assistant.transfer_queue.
Dieses Beispiel startet werktags um halb sieben einen Radiosender in der Küche:
1alias: Radio am Morgen
2triggers:
3 - trigger: time
4 at: "06:30:00"
5conditions:
6 - condition: time
7 weekday:
8 - mon
9 - tue
10 - wed
11 - thu
12 - fri
13actions:
14 - action: music_assistant.play_media
15 target:
16 entity_id: media_player.kueche
17 data:
18 media_id: "Radio Eins"
19 media_type: radioZwei Stellen musst du anpassen: media_player.kueche ist der Mediaplayer, den die Integration für deinen Lautsprecher angelegt hat. Radio Eins steht für einen Sender, den Music Assistant unter diesem Namen findet. Für media_type gehen außerdem artist, album, track, playlist, podcast, audiobook sowie folder.
Zum Ausschalten reicht die normale Aktion media_player.media_stop auf denselben Mediaplayer.
Ein Beispiel aus der Praxis ist der Tonie Adventskalender mit Home Assistant. Dort baue ich einen Adventskalender für den Kreativ-Tonie, der auf Music Assistant aufsetzt.
Tipps und Troubleshooting
| Problem | Ursache | Lösung |
|---|---|---|
| Lautsprecher werden nicht gefunden | Im Netz kommen die Multicast-Ankündigungen nicht durch, etwa wegen Gast-WLAN, VPN, VLAN oder eines Routers, der Multicast filtert | Server und Lautsprecher in dasselbe Netz legen. Bei Ubiquiti die Einstellung „Multicast to Unicast" ausschalten |
| Spotify spielt nichts ab | Spotify-Konto wurde seit Dezember 2024 angelegt und die Wiedergabe läuft über librespot | Die Einrichtung von Spotify noch einmal durchlaufen und Spotify Soloist wählen |
| Spotify lässt sich gar nicht anbinden | Kostenloses Konto | Geht nur mit Premium |
| Apple Music funktioniert plötzlich nicht mehr | Die Anmeldung ist nach 180 Tagen abgelaufen | In der Musikquelle neu anmelden |
| Nach der Apple-Anmeldung passiert nichts | Music Assistant war nicht über die eigene Adresse mit Port 8095 geöffnet | Music Assistant über http://<IP>:8095 aufrufen und die Anmeldung dort wiederholen |
| Pause zwischen zwei Titeln oder Abbruch beim Titelwechsel | Jeder Titel wird einzeln an den Lautsprecher geschickt | In den Einstellungen des Wiedergabegeräts den Queue Flow Mode einschalten (in der Doku „Enable queue flow mode"). Die meisten Geräte zeigen dann keine Titelinformationen mehr |
| Aussetzer bei Lautsprechern im WLAN | Music Assistant streamt in hoher Qualität, das WLAN kommt nicht mit | Lautsprecher verkabeln oder in den Einstellungen des Wiedergabegeräts einen verlustbehafteten Codec wählen |
Mehr Fälle sammelt die Fehlersuche in der Doku.
