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
temp/Album/CD1/
track01.flac
track02.flac
temp/Album/
CD1/
track01.flac ← kein CDDB-Treffer
track02.flac
album.json ← automatisch erzeugt, wenn CDDB Daten liefert
├─ 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)
│ → album.json prüfen/korrigieren
│ → musiksammlung apply
@ -73,10 +75,10 @@ temp/Album/CD1/
musiksammlung apply ← Umbenennen, Tags, Cover, Playlist
├─ --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
~/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/
Beethoven_Sinfonien/
CD1/
01_Allegro_con_brio_Karajan.flac
02_Andante_con_moto_Karajan.flac
01_-_Allegro_con_brio_-_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:**
```
@ -219,13 +223,20 @@ In diesem Fall `album.json` manuell ergänzen, dann `apply` erneut aufrufen.
{
"disc_number": 1,
"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
@ -242,7 +253,7 @@ musiksammlung apply ~/rip/Beethoven_Sinfonien album.json --in-place
```
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)
- Kopiert Cover-Bilder (`back.jpg`)
- Erzeugt eine M3U-Playlist
@ -251,8 +262,8 @@ Ergebnis:
```
~/rip/Beethoven_Sinfonien/
CD1/
01_Allegro_con_brio.flac
02_Andante_con_moto.flac
01_-_Allegro_con_brio_-_Karajan.flac
02_-_Andante_con_moto_-_Karajan.flac
...
CD2/
...
@ -273,7 +284,7 @@ Ergebnis:
Karajan/
Beethoven_Sinfonien_1963/
CD1/
01_Allegro_con_brio.flac
01_-_Allegro_con_brio_-_Karajan.flac
...
back.jpg
Beethoven_Sinfonien.m3u
@ -291,12 +302,15 @@ Ergebnis:
### Dateinamen-Schema
```
<Track-Nr>_<Titel>.<Endung>
<Track-Nr>_-_<Titel>_-_<Künstler>.<Endung>
```
Beispiel: `01_-_Allegro_con_brio_-_Karajan.flac`
- Leerzeichen und Satzzeichen → `_`
- Mehrere `_` hintereinander → ein `_`
- Umlaute (ä, ö, ü, ß) bleiben erhalten
- Künstler pro Track: falls im `album.json` ein Track-`artist` gesetzt ist, wird dieser verwendet; sonst der Album-Künstler
---