Bedienungsanleitung aktualisieren: neues Dateinamen-Schema und CDDB→album.json

- Workflow-Diagramm: CDDB speichert album.json automatisch
- Rip-Ergebnis: korrektes Schema 01_-_Titel_-_Kuenstler.flac
- apply-Ergebnisse: Dateinamen angepasst
- album.json: optionales Track-artist-Feld erklärt
- Dateinamen-Schema-Abschnitt: vollständige Beschreibung

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Dieter Schlüter 2026-02-18 00:26:09 +01:00
commit c9152cf19f

View file

@ -59,12 +59,14 @@ CD einlegen
musiksammlung rip ← CDs rippen, CDDB-Lookup, Dateien benennen musiksammlung rip ← CDs rippen, CDDB-Lookup, Dateien benennen
temp/Album/CD1/ temp/Album/
track01.flac CD1/
track01.flac ← kein CDDB-Treffer
track02.flac track02.flac
album.json ← automatisch erzeugt, wenn CDDB Daten liefert
├─ CDDB hat alles erkannt? ├─ CDDB hat alles erkannt?
│ ja → track01.flac bereits umbenannt → musiksammlung apply │ ja → album.json bereits vorhanden → musiksammlung apply
│ nein → musiksammlung scan (Coverbild/Text → album.json) │ nein → musiksammlung scan (Coverbild/Text → album.json)
│ → album.json prüfen/korrigieren │ → album.json prüfen/korrigieren
│ → musiksammlung apply │ → musiksammlung apply
@ -73,10 +75,10 @@ temp/Album/CD1/
musiksammlung apply ← Umbenennen, Tags, Cover, Playlist musiksammlung apply ← Umbenennen, Tags, Cover, Playlist
├─ --in-place (Standard): Dateien bleiben im Quellverzeichnis ├─ --in-place (Standard): Dateien bleiben im Quellverzeichnis
│ temp/Album/CD1/01_Titel.flac │ temp/Album/CD1/01_-_Titel_-_Kuenstler.flac
└─ mit output_dir: Dateien in Jellyfin-Struktur verschieben └─ mit output_dir: Dateien in Jellyfin-Struktur verschieben
~/Musik/Kuenstler/Album/CD1/01_Titel.flac ~/Musik/Kuenstler/Album/CD1/01_-_Titel_-_Kuenstler.flac
``` ```
--- ---
@ -142,10 +144,12 @@ Next album? (y/n): n
~/rip/ ~/rip/
Beethoven_Sinfonien/ Beethoven_Sinfonien/
CD1/ CD1/
01_Allegro_con_brio_Karajan.flac 01_-_Allegro_con_brio_-_Karajan.flac
02_Andante_con_moto_Karajan.flac 02_-_Andante_con_moto_-_Karajan.flac
... ...
album.json ← automatisch gespeichert
``` ```
→ Direkt weiter mit `musiksammlung apply ~/rip/Beethoven_Sinfonien album.json`
**Wenn kein CDDB-Treffer:** **Wenn kein CDDB-Treffer:**
``` ```
@ -219,13 +223,20 @@ In diesem Fall `album.json` manuell ergänzen, dann `apply` erneut aufrufen.
{ {
"disc_number": 1, "disc_number": 1,
"tracks": [ "tracks": [
{"track_number": 1, "title": "Allegro con brio", "artist": "Karajan"} {"track_number": 1, "title": "Allegro con brio"},
{"track_number": 2, "title": "Andante con moto"}
] ]
} }
] ]
} }
``` ```
Das Feld `"artist"` auf Track-Ebene ist **optional**. Wird es gesetzt, überschreibt es den Album-Künstler für diesen Track — sinnvoll bei Samplern oder Klassik mit verschiedenen Solisten:
```json
{"track_number": 3, "title": "Klavierkonzert Nr. 5", "artist": "Brendel"}`
```
--- ---
## 6. Schritt 3: Dateien organisieren und taggen ## 6. Schritt 3: Dateien organisieren und taggen
@ -242,7 +253,7 @@ musiksammlung apply ~/rip/Beethoven_Sinfonien album.json --in-place
``` ```
Das Programm: Das Programm:
- Benennt Audiodateien um (`track01.flac``01_Allegro_con_brio.flac`) - Benennt Audiodateien um (`track01.flac``01_-_Allegro_con_brio_-_Karajan.flac`)
- Setzt ID3/FLAC-Tags (Titel, Künstler, Album, Jahr, Track-Nummer, Disc-Nummer) - Setzt ID3/FLAC-Tags (Titel, Künstler, Album, Jahr, Track-Nummer, Disc-Nummer)
- Kopiert Cover-Bilder (`back.jpg`) - Kopiert Cover-Bilder (`back.jpg`)
- Erzeugt eine M3U-Playlist - Erzeugt eine M3U-Playlist
@ -251,8 +262,8 @@ Ergebnis:
``` ```
~/rip/Beethoven_Sinfonien/ ~/rip/Beethoven_Sinfonien/
CD1/ CD1/
01_Allegro_con_brio.flac 01_-_Allegro_con_brio_-_Karajan.flac
02_Andante_con_moto.flac 02_-_Andante_con_moto_-_Karajan.flac
... ...
CD2/ CD2/
... ...
@ -273,7 +284,7 @@ Ergebnis:
Karajan/ Karajan/
Beethoven_Sinfonien_1963/ Beethoven_Sinfonien_1963/
CD1/ CD1/
01_Allegro_con_brio.flac 01_-_Allegro_con_brio_-_Karajan.flac
... ...
back.jpg back.jpg
Beethoven_Sinfonien.m3u Beethoven_Sinfonien.m3u
@ -291,12 +302,15 @@ Ergebnis:
### Dateinamen-Schema ### Dateinamen-Schema
``` ```
<Track-Nr>_<Titel>.<Endung> <Track-Nr>_-_<Titel>_-_<Künstler>.<Endung>
``` ```
Beispiel: `01_-_Allegro_con_brio_-_Karajan.flac`
- Leerzeichen und Satzzeichen → `_` - Leerzeichen und Satzzeichen → `_`
- Mehrere `_` hintereinander → ein `_` - Mehrere `_` hintereinander → ein `_`
- Umlaute (ä, ö, ü, ß) bleiben erhalten - Umlaute (ä, ö, ü, ß) bleiben erhalten
- Künstler pro Track: falls im `album.json` ein Track-`artist` gesetzt ist, wird dieser verwendet; sonst der Album-Künstler
--- ---