Zum Inhalt springen
Alles Automatisch
Videos

Apple

Music Assistant einrichten: Spotify, Apple Music, Multiroom

Für alle ab
Für Mitglieder freigeschaltet

Früher Zugang für Kanalmitglieder

Das Video läuft schon, nur noch nicht für alle.

Kanalmitglieder sehen es jetzt. Für alle erscheint es am Mittwoch, 25. November, um 19 Uhr. Die komplette Anleitung kannst du heute schon lesen, sie steht direkt darunter.

Mitglieder seit 17. Nov.Für alle am Mi., 25. Nov.
noch 6 Tage

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

  1. Öffne in Home Assistant Einstellungen → Apps und klicke unten auf App installieren. Bis Home Assistant 2026.1 heißt der Bereich „Add-ons".
  2. Suche nach music und 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.
  3. 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

  1. Öffne in Music Assistant Einstellungen → Musikquellen.
  2. Klicke auf Füge eine Musikquelle hinzu.
  3. 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:

librespotSpotify Soloist
Was es istvon der Community gebaut, voreingestelltSpotifys eigene Abspielsoftware für Geräte ohne Bildschirm
Konten, die seit Dezember 2024 angelegt wurdenspielen meist nichtfunktionieren
Beste QualitätOgg Vorbis mit 320 kbit/sverlustfrei bis 24 Bit und 44,1 kHz
Einrichtungeine einmalige Freigabe der WiedergabeBedingungen bestätigen, API-Schlüssel anlegen, koppeln
Start der Wiedergabe und Spulenschnelldauert etwas länger
Zwei Wiedergabegeräte gleichzeitiggehteines 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

  1. Öffne die Suche und gib einen Begriff ein, bei mir „Bibi Blocksberg".
  2. Music Assistant zeigt die Treffer aus allen Quellen, die du angebunden hast. Bei jedem Treffer steht, aus welchem Dienst er kommt.
  3. Mit Mehr anzeigen klappst du weitere Treffer auf. Oben filterst du nach Titeln, Interpreten, Alben, Wiedergabelisten, Podcasts oder Hörbüchern.
  4. 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.

  1. Füge das Party-Plugin hinzu: Einstellungen → Plugins → Plugin hinzufügen → Party.
  2. Öffne in der Seitenleiste die Party und aktiviere dort den Gastzugang. Denselben Schalter gibt es in den Einstellungen des Plugins.
  3. Die Party-Ansicht zeigt jetzt einen QR-Code. Deine Gäste scannen ihn mit der Handykamera und landen auf einer eigenen Seite im Browser.
  4. 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.

  1. Öffne Einstellungen → Geräte & Dienste.
  2. Meist steht Music Assistant schon unter Entdeckt. Dann fügst du es dort hinzu.
  3. Steht es dort nicht, klickst du unten rechts auf Integration hinzufügen, suchst nach Music Assistant und 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:

yaml
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: radio

Zwei 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

ProblemUrsacheLösung
Lautsprecher werden nicht gefundenIm Netz kommen die Multicast-Ankündigungen nicht durch, etwa wegen Gast-WLAN, VPN, VLAN oder eines Routers, der Multicast filtertServer und Lautsprecher in dasselbe Netz legen. Bei Ubiquiti die Einstellung „Multicast to Unicast" ausschalten
Spotify spielt nichts abSpotify-Konto wurde seit Dezember 2024 angelegt und die Wiedergabe läuft über librespotDie Einrichtung von Spotify noch einmal durchlaufen und Spotify Soloist wählen
Spotify lässt sich gar nicht anbindenKostenloses KontoGeht nur mit Premium
Apple Music funktioniert plötzlich nicht mehrDie Anmeldung ist nach 180 Tagen abgelaufenIn der Musikquelle neu anmelden
Nach der Apple-Anmeldung passiert nichtsMusic Assistant war nicht über die eigene Adresse mit Port 8095 geöffnetMusic Assistant über http://<IP>:8095 aufrufen und die Anmeldung dort wiederholen
Pause zwischen zwei Titeln oder Abbruch beim TitelwechselJeder Titel wird einzeln an den Lautsprecher geschicktIn 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 WLANMusic Assistant streamt in hoher Qualität, das WLAN kommt nicht mitLautsprecher verkabeln oder in den Einstellungen des Wiedergabegeräts einen verlustbehafteten Codec wählen

Mehr Fälle sammelt die Fehlersuche in der Doku.

Diskussion im Forum

Hast du Fragen oder Ideen zu diesem Thema?

Diskutiere im Forum

Video teilen

Community

Unterstütze den Kanal

Hat dir der Beitrag geholfen? Es gibt zwei Wege, etwas zurückzugeben.