diff --git a/BEDIENUNGSANLEITUNG.md b/BEDIENUNGSANLEITUNG.md index 4d779d0..518b8a7 100644 --- a/BEDIENUNGSANLEITUNG.md +++ b/BEDIENUNGSANLEITUNG.md @@ -58,19 +58,24 @@ CD einlegen │ ▼ musiksammlung rip ← CDs rippen, CDDB-Lookup, Dateien benennen - │ + │ (optional: EAN-Abfrage → MusicBrainz) ▼ temp/Album/ CD1/ track01.flac ← kein CDDB-Treffer track02.flac - album.json ← automatisch erzeugt, wenn CDDB Daten liefert + album.json ← automatisch erzeugt (CDDB oder MusicBrainz) │ - ├─ CDDB hat alles erkannt? - │ ja → album.json bereits vorhanden → musiksammlung apply - │ nein → musiksammlung scan (Coverbild/Text → album.json) - │ → album.json prüfen/korrigieren - │ → musiksammlung apply + ├─ album.json bereits vorhanden (CDDB/MusicBrainz)? + │ ja → direkt weiter mit musiksammlung apply + │ + └─ nein → album.json manuell erzeugen (eine Variante wählen): + A: musiksammlung scan --from-text trackliste.txt + B: musiksammlung scan back.jpg + C: musiksammlung scan back.jpg --vision + D: musiksammlung scan --barcode 0602557360561 + → album.json prüfen/korrigieren + → musiksammlung apply │ ▼ musiksammlung apply ← Umbenennen, Tags, Cover, Playlist @@ -117,6 +122,9 @@ musiksammlung rip -f flac -q high -j 0 -P -o ~/rip ``` --- Album 1 --- Album name (Enter = CDDB name / default 'Album1'): Beethoven Sinfonien +EAN/Barcode für MusicBrainz (Enter = überspringen): 028943753227 + MusicBrainz-Suche nach Barcode 028943753227 ... + ✓ Herbert von Karajan – Beethoven: 9 Symphonies (1963, 50 Tracks) Album: Beethoven Sinfonien CD Drive: /dev/cdrom @@ -191,14 +199,28 @@ musiksammlung scan back.jpg -o album.json --model llama3.3:latest Besser als OCR bei komplexen Layouts (mehrere Spalten, schwierige Schriften): ```bash -musiksammlung scan back.jpg --vision --vision-model qwen3-vl:latest -o album.json +musiksammlung scan back.jpg --vision -o album.json ``` -Für mehrspaltige Tracklisten auf CD-Rückseiten das große Cloud-Modell nutzen: +Standard-Modell: `qwen3-vl:235b-cloud` (via Ollama). Anderes Modell: ```bash -musiksammlung scan back.jpg --vision --vision-model qwen3-vl:235b-cloud -o album.json +musiksammlung scan back.jpg --vision --vision-model qwen3-vl:7b -o album.json ``` +### Variante D: EAN/Barcode → MusicBrainz (schnellste Methode) + +Wenn die EAN-13- oder UPC-12-Nummer der CD bekannt ist (aufgedruckt auf der Hülle), kann das Programm die Metadaten direkt aus der [MusicBrainz](https://musicbrainz.org)-Datenbank laden — ohne Bild, ohne OCR, ohne lokales LLM: + +```bash +musiksammlung scan --barcode 0602557360561 -o album.json +``` + +Die EAN lässt sich auch mit einem Barcode-Scanner oder einer Smartphone-App ablesen. + +MusicBrainz liefert bei einem Treffer: Interpret, Albumtitel, Erscheinungsjahr und vollständige Trackliste. Kein API-Schlüssel erforderlich. + +Alternativ kann die EAN auch während des interaktiven Rippens eingegeben werden (Abfrage „EAN/Barcode für MusicBrainz"). Das Ergebnis wird dann direkt als `album.json` gespeichert. + ### album.json prüfen und bearbeiten Das Programm prüft automatisch, ob die Anzahl der erkannten Tracks mit den gerippten Dateien übereinstimmt. Bei Abweichungen erscheint eine Fehlermeldung: @@ -368,15 +390,21 @@ musiksammlung process temp/Album/CD1 ~/Musik --back back.jpg ## 9. Tipps und Hinweise +**EAN/Barcode verfügbar? → Schnellster Weg** +- EAN-13 oder UPC-12 von der CD-Hülle ablesen (ggf. Barcode-Scanner-App nutzen) +- `musiksammlung scan --barcode 0602557360561 -o album.json` +- Oder beim `rip`-Befehl die EAN-Abfrage verwenden — dann wird `album.json` direkt gespeichert +- Kein Bild, kein OCR, kein lokales LLM notwendig + **CDDB-Lookup schlägt fehl?** - Internetverbindung prüfen -- `--no-cddb` verwenden und Metadaten manuell per `scan` ermitteln +- `--no-cddb` verwenden und Metadaten per `scan --barcode` oder `scan` (Bild) ermitteln **Falsches oder kein CDDB-Ergebnis?** - Tracks sind trotzdem korrekt gerippt (als `track01.flac` etc.) -- `musiksammlung scan` mit Coverbild oder Textdatei aufrufen -- `album.json` manuell korrigieren -- `musiksammlung apply` ausführen +- `musiksammlung scan --barcode EAN` verwenden (wenn EAN bekannt) +- Oder `musiksammlung scan` mit Coverbild oder Textdatei aufrufen +- `album.json` manuell korrigieren, dann `musiksammlung apply` ausführen **Mehrspaltige Trackliste auf dem Backcover?** - OCR erkennt mehrspaltige Layouts oft unvollständig diff --git a/README.md b/README.md index a1c752a..3c45cd4 100644 --- a/README.md +++ b/README.md @@ -30,11 +30,14 @@ pip install -e ".[dev]" ## Schnellstart ```bash -# CDs rippen +# CDs rippen (interaktiv, mit optionaler EAN-Abfrage für MusicBrainz) musiksammlung rip -j 0 -P -# Coverbild scannen → album.json erzeugen -musiksammlung scan back.jpg -o album.json +# Variante A: EAN/Barcode → MusicBrainz → album.json (schnellste Methode) +musiksammlung scan --barcode 0602557360561 -o album.json + +# Variante B: Coverbild per Vision-LLM → album.json +musiksammlung scan back.jpg --vision -o album.json # Audiodateien organisieren und taggen musiksammlung apply temp/Album1/CD1 album.json ~/Musik