Wie können wir helfen?

Prüfe, ob der Server läuft und sich seine Weboberfläche im selben Netzwerk öffnen lässt. Kontrolliere die Freigabe für das lokale Netzwerk, die vollständige Serveradresse sowie gegebenenfalls VPN und Reverse Proxy. Verwende die endgültige Serveradresse: Native API-Anfragen folgen keinen Weiterleitungen. Öffentlich erreichbare Serveradressen benötigen HTTPS mit gültigem Zertifikat. Lokale HTTP-Verbindungen sind unverschlüsselt.

Wähle Erneut verbinden. Ein vorübergehender Netzwerkausfall entfernt deine gespeicherte Anmeldung nicht. Bei abgelaufener oder widerrufener Sitzung musst du dich erneut anmelden.

Prüfe, ob Home Assistant auf dem Music-Assistant-Server als Anmeldeanbieter aktiviert ist und die normale Anmeldeseite des Servers funktioniert. Schließe auf Apple TV die Systemabfrage auf dem nahen iPhone oder iPad ab. Alternativ kannst du ein direktes Music-Assistant-Konto oder einen persönlichen Token verwenden. Behebe Zertifikatsfehler am Server.

Prüfe dasselbe Benutzerkonto in der Music-Assistant-Weboberfläche. Der Server legt fest, welche Dienste und Player dein Konto sehen darf. Ein Dienst muss verbunden, verfügbar und für das Konto freigegeben sein. Die App übernimmt keine Anmeldungen aus anderen installierten Musik-Apps. Mit Mehr laden rufst du weitere Mediathek-Einträge ab.

Richte den Dienst in Music Assistant ein. Auf iPhone und Mac öffnet Profil → Musikdienste verbinden & verwalten die Dienstverwaltung des Servers. Dafür können Administratorrechte erforderlich sein. Verwende für Apple TV die Serveroberfläche auf einem iPhone oder Computer. Die Zugangsdaten des Musikdienstes bleiben beim Server und beim jeweiligen Anbieter.

MusicAssistantMate steuert derzeit vorhandene Music-Assistant-Player. Die App gibt selbst kein Audio auf iPhone, Mac, Apple TV oder Apple Watch aus. Wähle unter Räume einen verfügbaren Player, prüfe dessen Lautstärke und teste die Wiedergabe in Music Assistant.

Wähle unter Räume → Lautsprecher verbinden kompatible Geräte aus. Welche Gruppen möglich sind, hängt von den Playern und den von Music Assistant gemeldeten Fähigkeiten ab. Dauerhafte Gruppen und Kompatibilitätsfragen verwaltest du am Server.

Dein Gerät muss den Music-Assistant-Server erreichen können, beispielsweise über ein VPN oder einen sicher eingerichteten HTTPS-Zugang. Die App stellt keinen eigenen Fernzugriffsdienst bereit. Der Music-Assistant-Fernzugriff über WebRTC ist derzeit nicht implementiert.

Öffne die iPhone-App, melde dich an und prüfe ihre Serververbindung. Tippe anschließend in der Watch-App auf Aktualisieren. Halte die Begleitverbindung verfügbar und beide Apps aktuell. Die Uhr steuert über das iPhone und verbindet sich nicht direkt mit dem Server. Ein zuletzt geladener Titel kann sichtbar bleiben, obwohl die Steuerung gerade nicht verfügbar ist. Befehle werden nicht für später vorgemerkt.

Die Suche hängt vom Dienst, den Kontofreigaben und deiner Music-Assistant-Version ab. Bei mehreren Konten desselben Dienstes kann die Katalogsuche unterschiedlich umfangreich sein. Beachte den jeweiligen Dienstabschnitt und Hinweise in der App; Mediathek- und Katalogtreffer sind nicht immer identisch.