Mobile MA – nativer iOS-Client für Music Assistant

Wer Music Assistant auf dem eigenen Heimserver betreibt und schon länger auf einen vollwertigen nativen iOS-Client gewartet hat: Die Wartezeit ist vorbei. Mobile MA ist eine in SwiftUI entwickelte iPhone-App, die sich per WebSocket direkt mit eurer Music Assistant-Instanz verbindet und die vollständige Kontrolle über eure Musikbibliothek ins Smartphone bringt.

Was ist Mobile MA?

Music Assistant ist eine weit verbreitete selbst-gehostete Musik-Streaming-Plattform, die Quellen wie Navidrome/Subsonic, Apple Music, Spotify und lokale Dateisysteme in einer einheitlichen Bibliothek zusammenführt. Mobile MA ist ein dedizierter nativer iOS-Client dafür – vollständig mit SwiftUI gebaut, ohne externe Abhängigkeiten, und zielt auf iOS 17 und höher ab.

Die App wurde von Sven Hanold entwickelt und im April 2026 erstmals im App Store eingereicht. Sie befindet sich aktuell bei Version 1.4 und wird aktiv weiterentwickelt.

Features im Überblick

Bibliothek

Der Library-Tab gibt Zugriff auf die gesamte Musiksammlung, aufgeteilt in sieben Bereiche: Album Artists, Artists, Albums, Playlists, Podcasts, Radio und Favorites. Eine alphabetische Sidebar auf der rechten Seite ermöglicht schnelles Springen durch große Künstler- oder Albumlisten. Alle Daten werden lokal auf dem Gerät gecacht, mit Lazy Pagination in 50er-Blöcken. Pull-to-refresh synchronisiert jederzeit frische Daten vom Server.

Player-Steuerung

Der Players-Tab zeigt alle verfügbaren Music Assistant Player als Karten – mit verwischtem Cover-Art als Hintergrund, einer Wellenform-Animation bei laufender Wiedergabe und einem Play/Pause-Button. Ein Tipp auf eine Karte öffnet die vollständige Now Playing View mit Transport-Steuerung (Zurück, Play/Pause, Weiter), einem flüssig clientseitig aktualisierten Fortschrittsbalken sowie einem Lautstärke-Slider mit Mute-Toggle und ±5-Schritt-Buttons.

Musik in mehreren Räumen synchron abspielen? Einfach den Drag Handle einer Player-Karte lang halten und auf eine andere Karte ziehen – Mobile MA erstellt über die Music Assistant API eine Sync-Gruppe. Auflösen geht mit einem Tipp auf den roten ✕-Button.

Queue-Verwaltung

Die neu gestaltete Queue-Ansicht (eingeführt in v1.4) zeigt die vollständige Wiedergabeliste, mit dem aktuellen Track hervorgehoben und automatisch sichtbar. Ein Tipp auf einen Eintrag springt direkt zu diesem Track. Einzelne Tracks lassen sich aus der Queue entfernen. Alben und Playlists können sofort gestartet oder hinten an die aktuelle Queue angehängt werden – bei mehreren Playern erscheint ein Player-Picker-Sheet zur Auswahl.

Suche

Volltextsuche über die gesamte Bibliothek. Ergebnisse erscheinen nach kurzer Tipp-Pause und sind nach Typ gruppiert: Artists, Albums, Tracks, Playlists und Radio-Sender. Ein Tipp auf ein Ergebnis navigiert direkt zur entsprechenden Detailseite oder startet bei Radio sofort die Wiedergabe.

Favoriten

Jeder Künstler, jedes Album und jeder Track kann über das Herz-Icon als Favorit markiert werden. Die UI aktualisiert sich optimistisch sofort und synchronisiert den Status im Hintergrund mit dem Server. Seit v1.4 bestätigt ein kurzer Toast-Hinweis das Setzen oder Entfernen eines Favoriten. Alle Favoriten sind außerdem direkt über den eigenen Favorites-Tab in der Library erreichbar.

Podcasts

Mit v1.2 eingeführt: Der Podcasts-Bereich listet alle abonnierten Podcasts und deren Episoden direkt in der Library. Die Wiedergabe von Podcast-Episoden läuft über dieselbe Player-Infrastruktur wie Musik.

Technischer Unterbau

Mobile MA basiert auf einer sauberen Schichtenarchitektur mit Swifts @Observable-Framework (Swift 5.9). Das zentrale MAService-Objekt koordiniert vier Sub-Manager: Authentifizierung (Keychain-basierte Long-Lived Tokens), WebSocket-Kommunikation, Player-Zustand und Bibliotheksdaten mit Disk-Cache. Alle drei werden als SwiftUI-Environment-Werte injiziert – kein Drittanbieter-Framework nötig.

Bild-Caching läuft über ein eigenes dreistufiges System: NSCache (Memory-LRU) → Disk → Netzwerk. In-App-Purchases werden über StoreKit 2 abgewickelt und bieten optionale Donation-Stufen (Song, Album, Anthology).

Was kommt als Nächstes?

Die Roadmap enthält einige geplante Erweiterungen. Kurzfristig: Shuffle- und Repeat-Steuerung, interaktives Seeking im Fortschrittsbalken sowie direkte Track-Wiedergabe aus den Suchergebnissen. Mittelfristig: ein iPad-optimiertes Split-View-Layout, Lock-Screen-Widgets und Live Activities, Queue-Reordering per Drag & Drop, ein Sleep Timer und Siri/App Intents-Integration. Langfristig auf dem Wunschzettel stehen Multi-Server-Support, eine Apple Watch Companion App, AirPlay-Routing und CarPlay-Unterstützung.

Verfügbarkeit

Mobile MA ist im App Store für iPhone verfügbar. Voraussetzung sind iOS 17 oder neuer sowie ein laufender Music Assistant Server im lokalen Netzwerk oder erreichbar über einen Reverse Proxy. Die App ist kostenlos; über In-App-Purchases können optional Spenden zur Unterstützung der Weiterentwicklung geleistet werden.


Versionschronik:
Alle Versionen und Updates: Mobile MA-Übersicht
Hilfe & Fragen: Support-Formular