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
|
musiksammlung rip ← CDs rippen, CDDB-Lookup, Dateien benennen
|
||||||
│
|
│ (optional: EAN-Abfrage → MusicBrainz)
|
||||||
▼
|
▼
|
||||||
temp/Album/
|
temp/Album/
|
||||||
CD1/
|
CD1/
|
||||||
track01.flac ← kein CDDB-Treffer
|
track01.flac ← kein CDDB-Treffer
|
||||||
track02.flac
|
track02.flac
|
||||||
album.json ← automatisch erzeugt, wenn CDDB Daten liefert
|
album.json ← automatisch erzeugt (CDDB oder MusicBrainz)
|
||||||
│
|
│
|
||||||
├─ CDDB hat alles erkannt?
|
├─ album.json bereits vorhanden (CDDB/MusicBrainz)?
|
||||||
│ ja → album.json bereits vorhanden → musiksammlung apply
|
│ ja → direkt weiter mit musiksammlung apply
|
||||||
│ nein → musiksammlung scan (Coverbild/Text → album.json)
|
│
|
||||||
│ → album.json prüfen/korrigieren
|
└─ nein → album.json manuell erzeugen (eine Variante wählen):
|
||||||
│ → musiksammlung apply
|
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
|
musiksammlung apply ← Umbenennen, Tags, Cover, Playlist
|
||||||
|
|
@ -117,6 +122,9 @@ musiksammlung rip -f flac -q high -j 0 -P -o ~/rip
|
||||||
```
|
```
|
||||||
--- Album 1 ---
|
--- Album 1 ---
|
||||||
Album name (Enter = CDDB name / default 'Album1'): Beethoven Sinfonien
|
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
|
Album: Beethoven Sinfonien
|
||||||
CD Drive: /dev/cdrom
|
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):
|
Besser als OCR bei komplexen Layouts (mehrere Spalten, schwierige Schriften):
|
||||||
|
|
||||||
```bash
|
```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
|
```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
|
### 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:
|
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
|
## 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?**
|
**CDDB-Lookup schlägt fehl?**
|
||||||
- Internetverbindung prüfen
|
- 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?**
|
**Falsches oder kein CDDB-Ergebnis?**
|
||||||
- Tracks sind trotzdem korrekt gerippt (als `track01.flac` etc.)
|
- Tracks sind trotzdem korrekt gerippt (als `track01.flac` etc.)
|
||||||
- `musiksammlung scan` mit Coverbild oder Textdatei aufrufen
|
- `musiksammlung scan --barcode EAN` verwenden (wenn EAN bekannt)
|
||||||
- `album.json` manuell korrigieren
|
- Oder `musiksammlung scan` mit Coverbild oder Textdatei aufrufen
|
||||||
- `musiksammlung apply` ausführen
|
- `album.json` manuell korrigieren, dann `musiksammlung apply` ausführen
|
||||||
|
|
||||||
**Mehrspaltige Trackliste auf dem Backcover?**
|
**Mehrspaltige Trackliste auf dem Backcover?**
|
||||||
- OCR erkennt mehrspaltige Layouts oft unvollständig
|
- OCR erkennt mehrspaltige Layouts oft unvollständig
|
||||||
|
|
|
||||||
|
|
@ -30,11 +30,14 @@ pip install -e ".[dev]"
|
||||||
## Schnellstart
|
## Schnellstart
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# CDs rippen
|
# CDs rippen (interaktiv, mit optionaler EAN-Abfrage für MusicBrainz)
|
||||||
musiksammlung rip -j 0 -P
|
musiksammlung rip -j 0 -P
|
||||||
|
|
||||||
# Coverbild scannen → album.json erzeugen
|
# Variante A: EAN/Barcode → MusicBrainz → album.json (schnellste Methode)
|
||||||
musiksammlung scan back.jpg -o album.json
|
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
|
# Audiodateien organisieren und taggen
|
||||||
musiksammlung apply temp/Album1/CD1 album.json ~/Musik
|
musiksammlung apply temp/Album1/CD1 album.json ~/Musik
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue