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:
parent
b30aaa617d
commit
b70127e838
2 changed files with 48 additions and 17 deletions
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue