docs: document MusicBrainz barcode lookup in README and Bedienungsanleitung

- README: Schnellstart shows --barcode as fastest option
- Bedienungsanleitung:
  - Workflow diagram updated (EAN path, Varianten A-D)
  - Interactive rip example shows EAN prompt with MusicBrainz output
  - New Variante D: scan --barcode (no image, no OCR, no local LLM)
  - Variante C: corrected default model to qwen3-vl:235b-cloud
  - Tipps: barcode as first/fastest option, updated CDDB fallback hints

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Dieter Schlüter 2026-02-18 06:16:18 +01:00
commit b70127e838
2 changed files with 48 additions and 17 deletions

View file

@ -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

View file

@ -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