Export und Sicherung: Was ist enthalten?
Einstellungen & Daten, aktualisiert am
Luma kennt drei Wege, Daten aus der App zu holen: die Sicherung Luma-Daten als JSON-Datei, den Export der ganzen Mediathek als Ordner und das Teilen einzelner Audiodateien. Hier steht genau, was in welchem Weg steckt. Der Stand gilt ab Luma 1.5.1 auf iPhone und iPad und Luma für Mac 1.0.1.
Überblick
| Was | Luma-Daten (JSON) | Mediathek exportieren | Audiodateien teilen |
|---|---|---|---|
| Audiodateien | Nein | Ja, alle | Ja, die gewählten |
| Tags und eingebettete Cover | Titel, Interpret, Album, Länge, Titelnummer | Ja, in den Dateien | Ja, in den Dateien |
| Albumcover als Bild | Nein | Ja, als cover.jpg | Nein |
| Playlists mit Reihenfolge | Ja | Ja, als .m3u8 und in Luma Daten.json | Nur als nummerierte Dateinamen |
| Playlist-Cover | Stil und generiertes Muster, kein Foto | In der JSON wie links | Nein |
| Sammlungen | Ja, mit Reihenfolge der Alben | In der JSON wie links | Nein |
| Likes und Hörstatistiken | Ja, pro Song | In der JSON wie links | Nein |
Liedtexte aus .lrc-Dateien | Nein | Nein | Nein |
| Dynamische Playlists | Ja, Name und Regeln | In der JSON wie links | Nein |
| Equalizer, Einstellungen | Nein | Nein | Nein |
Alles, was hier fehlt, sichert das normale iCloud- oder Computer-Backup deines iPhones mit, denn es enthält Luma vollständig.
Die Sicherung Luma-Daten (JSON)
Auf iPhone und iPad findest du die Sicherung unter Einstellungen › Mediathek & Speicher › Sicherung: Daten exportieren speichert die Datei, Daten importieren liest sie wieder ein. Auf dem Mac steht sie unter Einstellungen › Mediathek › Sicherung oder im Menü Ablage › Daten exportieren… (⇧⌘E) und Daten importieren… (⇧⌘I). Die Datei heißt zum Beispiel Luma Daten 2026-10-23.json, du speicherst sie an einem Ort deiner Wahl, etwa in iCloud Drive.
Enthalten sind:
- der Name jeder Playlist und ihre Reihenfolge im Tab,
- die Songs jeder Playlist in ihrer Reihenfolge, je mit Titel, Interpret, Album, Länge in Sekunden und Titelnummer,
- der Cover-Stil der Playlist und die Einstellungen eines generierten Muster-Covers,
- jede Sammlung mit ihren Alben in ihrer Reihenfolge, je mit Albumtitel, Albuminterpret und Jahr,
- seit Luma 1.7 und Luma für Mac 1.2.0 jede dynamische Playlist mit Name und Regeln,
- für jeden Song der Mediathek: Wiedergaben, gehörte Zeit, zuletzt gespielt, Like und das Datum, an dem er hinzugekommen ist.
Nicht enthalten sind:
- die Musik selbst. Die Datei verweist nur auf Songs und Alben. Beim Einlesen sucht Luma sie in der Mediathek, siehe Wie Luma Songs zuordnet.
- Foto-Cover. Ein eigenes Foto verlässt dein Gerät nicht. Die Playlist kommt mit dem Mosaik-Cover zurück.
- Equalizer und alle Einstellungen.
Songs, die gerade grau sind, also nicht in der Mediathek liegen, sind in ihren Playlists trotzdem dabei: mit Titel, Interpret und Album, aber ohne Länge und Titelnummer.
Eine einzelne Playlist exportierst du weiter über ihr Menü mit Playlist exportieren. Diese Datei enthält nur die Playlist, ohne Sammlungen und Statistiken, und trägt ihren Namen. Eingelesen wird sie genauso über Daten importieren.
Wiederherstellen
- Erst die MusikImportiere zuerst deine Musik. Luma ordnet Playlists, Sammlungen und Statistiken nur Songs und Alben zu, die schon in der Mediathek sind.
- Dann die DateiDaten importieren wählen und die Datei auswählen.
- Ergebnis prüfenLuma meldet zum Beispiel 3 Playlists importiert, Statistiken für 1.204 Titel übernommen, 2 Sammlungen importiert.
Beim Einlesen gilt:
- Statistiken und Likes finden ihre Songs über Titel, Interpret und Album wieder, auch wenn die Dateien neu sind, etwa nach einer Neuinstallation oder in einem anderen Format. Bei Wiedergaben und gehörter Zeit gewinnt der höhere Wert, ein Like wird gesetzt, aber nie entfernt.
- Playlists und Sammlungen, die es mit gleichem Namen schon gibt, werden nicht doppelt angelegt. Luma ergänzt nur, was ihnen fehlt.
- Fehlende Songs erscheinen in Playlists als graue Einträge und rücken an ihren Platz, sobald du sie importierst. Fehlende Alben lässt Luma in Sammlungen weg. Liest du die Datei nach dem Import der Musik noch einmal ein, kommen sie dazu.
- Ein zweiter Import derselben Datei legt nichts doppelt an und zählt keine Wiedergaben doppelt. Luma meldet dann Alles aus dieser Datei ist bereits vorhanden.
Ältere Dateien wie Luma Playlists.json aus Luma 1.5 und früher liest Luma weiter ein. Sie enthalten nur Playlists.
So ist die JSON-Datei aufgebaut
Die Datei ist lesbarer Text. Du kannst sie in jedem Texteditor öffnen, prüfen und anpassen. Eine Sicherung mit einer Sammlung, einem Song und einer Playlist sieht so aus:
{
"collections" : [
{
"albums" : [
{
"artist" : "The Beatles",
"title" : "Abbey Road",
"year" : 1969
}
],
"name" : "Sechziger"
}
],
"library" : [
{
"added" : "2026-06-17T18:20:05Z",
"album" : "Abbey Road",
"artist" : "The Beatles",
"duration" : 185.7,
"lastPlayed" : "2026-10-22T07:41:30Z",
"listenSeconds" : 2228,
"liked" : true,
"playCount" : 12,
"title" : "Here Comes the Sun",
"trackNumber" : 7
}
],
"playlists" : [
{
"coverStyle" : 0,
"name" : "Sonntagmorgen",
"tracks" : [
{
"album" : "Abbey Road",
"artist" : "The Beatles",
"duration" : 185.7,
"title" : "Here Comes the Sun",
"trackNumber" : 7
}
]
}
],
"version" : 3
}
| Feld | Bedeutung | Pflicht |
|---|---|---|
version | Formatversion: 3 bei einer vollständigen Sicherung, 1 bei einer einzelnen Playlist | Ja |
playlists | Die Playlists in ihrer Reihenfolge, darf leer sein | Ja |
name, tracks | Name der Playlist und ihre Songs in ihrer Reihenfolge, tracks darf leer sein | Ja |
title, artist, album | Woran Luma den Song in der Mediathek erkennt | Ja, album darf leer sein |
duration, trackNumber | Länge in Sekunden und Titelnummer, nur zur Information | Nein |
coverStyle | 0 Mosaik, 2 generiertes Muster | Nein |
generatedCover | Farben und Form des generierten Musters | Nein |
library | Ein Eintrag pro Song mit seinen Statistiken, erkannt an title, artist und album | Nein |
playCount, listenSeconds | Wiedergaben und gehörte Zeit in Sekunden | Nein |
liked, lastPlayed, added | Like, zuletzt gespielt und hinzugefügt, Daten im Format ISO 8601 | Nein |
collections | Die Sammlungen mit name und albums in ihrer Reihenfolge | Nein |
albums: title, artist | Albumtitel und Albuminterpret, woran Luma das Album erkennt | Ja |
albums: year | Unterscheidet zwei gleichnamige Alben desselben Interpreten | Nein |
Weil nur Titel, Interpret und Album zählen, kannst du eine solche Datei auch selbst erstellen, etwa aus einer Liste, die du aus einer anderen App exportiert hast. Dafür reichen version und playlists. Halte dich an die Schreibweise deiner Tags. Kleine Abweichungen wie Groß- und Kleinschreibung, „feat.“-Zusätze oder Klammern verzeiht Luma, ganz andere Titel nicht.
Hat die Datei einen Fehler, etwa ein fehlendes Komma oder Anführungszeichen, meldet Luma beim Einlesen Import fehlgeschlagen. Die Datei ist keine Luma-Datensicherung. und ändert nichts.
Mediathek exportieren
Unter Einstellungen › Mediathek & Speicher › Mediathek exportieren kopiert Luma alle Titel in einen Ordner deiner Wahl, auf dem iPhone etwa nach iCloud Drive oder auf einen USB-Stick. Auf dem Mac heißt der Befehl Ablage › Mediathek exportieren…. Das Ergebnis ist ein Ordner, den jeder andere Player und jeder Dateimanager versteht:
Luma Mediathek 2026-10-23/
Künstler/Album/01 Titel.flac
Künstler/Album/cover.jpg
Playlists/Sonntagmorgen.m3u8
Luma Daten.json
- Ordner sind nach Albuminterpret und Album benannt. Bei Alben mit mehreren CDs heißen die Dateien
1-01 Titel,2-01 Titelund so weiter. - Die Dateien sind 1:1 Kopien in ihrem Originalformat. Infos, die du in Luma bearbeitet hast, stehen schon in den Dateien, sofern Luma sie hineinschreiben konnte.
cover.jpg(odercover.png) ist das Albumcover, so wie Luma es anzeigt.- Der Ordner
Playlistsenthält jede Playlist als.m3u8-Datei mit relativen Pfaden. Du kannst den ganzen Export also verschieben, die Playlists funktionieren weiter. Graue Songs fehlen darin, weil es keine Datei zu ihnen gibt. Luma Daten.jsonist dieselbe vollständige Sicherung wie oben, mit Playlists, Sammlungen, Likes und Statistiken, zum Einlesen in Luma. Sie wird nur angelegt, wenn du mindestens eine Playlist hast. Sonst exportierst du sie zusätzlich über Daten exportieren.
Vor dem Kopieren prüft Luma, ob am Ziel genug Platz ist. Brichst du ab, bleibt alles, was schon kopiert war, samt Covern und Playlists für diesen Teil erhalten. Der Ordner Luma in der Dateien-App ist als Ziel nicht erlaubt, weil Luma alles darin sofort wieder importieren würde.
Luma liest .m3u8-Dateien nicht ein. Um Playlists in Luma zurückzuholen, nimm immer die Luma Daten.json.
Audiodateien teilen
Auf iPhone und iPad hältst du einen Song, ein Album, einen Künstler oder eine Playlist gedrückt und wählst Audiodateien teilen (bei einem Song Audiodatei teilen). Das Teilen-Menü von iOS bietet dann In Dateien sichern, AirDrop und andere Apps an. Luma gibt den Dateien dabei lesbare Namen:
| Geteilt wird | Dateiname |
|---|---|
| Ein Song oder ein Künstler | Künstler - Titel.mp3 |
| Ein Album | 01 Titel.flac, bei mehreren CDs 1-01 Titel.flac |
| Eine Playlist | 01 Künstler - Titel.m4a, nummeriert in Playlist-Reihenfolge |
Graue Songs einer Playlist werden übersprungen. Die Kopien liegen nur kurz in einem temporären Ordner und belegen keinen zusätzlichen Platz.
Welcher Weg wofür?
- Playlists, Sammlungen, Likes und Statistiken aufs neue Gerät oder nach einer Neuinstallation: Luma-Daten.
- Komplettes Backup außerhalb von iCloud, Umzug auf einen Mac oder in einen anderen Player: Mediathek exportieren.
- Ein paar Alben an einen Freund oder an den Computer: Audiodateien teilen.
Mehr Abläufe Schritt für Schritt stehen in Tipps und Sonderfälle.
Noch Fragen oder einen Fehler gefunden? Schreib an hallo@suenavus.com.