dschlueter/Musiksammlung
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Docs: add --from-photo (Variante E) to scan command documentation

Browse source 
- BEDIENUNGSANLEITUNG: new Variante E section with usage examples,
  updated flowchart to include option E
- README: Schnellstart shows --from-photo as Variante A2

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Dieter Schlüter 2026-02-19 14:45:31 +01:00
commit 8e46c46263
2 changed files with 18 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

15
BEDIENUNGSANLEITUNG.md
View file

@ -98,6 +98,7 @@ EAN/Barcode eingeben ODER CD-Hülle fotografieren
B: musiksammlung scan back.jpg B: musiksammlung scan back.jpg
C: musiksammlung scan back.jpg --vision C: musiksammlung scan back.jpg --vision
D: musiksammlung scan --barcode 0602557360561 D: musiksammlung scan --barcode 0602557360561
E: musiksammlung scan --from-photo cover.jpg
→ album.json prüfen/korrigieren → album.json prüfen/korrigieren
│ │
▼ ▼
@ -341,6 +342,20 @@ MusicBrainz liefert bei einem Treffer: Interpret, Albumtitel, Erscheinungsjahr u
Beim interaktiven Rip-Befehl (`musiksammlung rip`) wird die EAN als erstes abgefragt. Bei einem MusicBrainz-Treffer startet automatisch der Rip-Vorgang für alle Discs — kein Albumname, keine CDDB-Bestätigung nötig. Das `album.json` wird direkt aus den MusicBrainz-Daten gespeichert. Beim interaktiven Rip-Befehl (`musiksammlung rip`) wird die EAN als erstes abgefragt. Bei einem MusicBrainz-Treffer startet automatisch der Rip-Vorgang für alle Discs — kein Albumname, keine CDDB-Bestätigung nötig. Das `album.json` wird direkt aus den MusicBrainz-Daten gespeichert.
### Variante E: EAN per Foto (Vision-LLM liest Barcode)
Wenn die EAN nicht bekannt ist, aber ein Foto der CD-Hülle vorliegt, kann ein Vision-LLM den Barcode automatisch auslesen:
```bash
musiksammlung scan --from-photo cover.jpg -o album.json
```
Das Programm schickt das Bild an das Vision-LLM (Standard: `qwen3-vl:235b-cloud`), extrahiert die EAN-Ziffern und führt anschließend einen MusicBrainz-Lookup durch — identisch zu Variante D. Anderes Modell oder URL:
```bash
musiksammlung scan --from-photo cover.jpg --vision-model qwen3-vl:7b --url http://localhost:11434 -o album.json
```
### 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:

3
README.md
View file

@ -40,6 +40,9 @@ musiksammlung rip -j 0 -P
# Variante A: EAN/Barcode → MusicBrainz → album.json (schnellste Methode) # Variante A: EAN/Barcode → MusicBrainz → album.json (schnellste Methode)
musiksammlung scan --barcode 0602557360561 -o album.json musiksammlung scan --barcode 0602557360561 -o album.json
# Variante A2: EAN per Foto (Vision-LLM liest Barcode) → MusicBrainz → album.json
musiksammlung scan --from-photo cover.jpg -o album.json
# Variante B: Coverbild per Vision-LLM → album.json # Variante B: Coverbild per Vision-LLM → album.json
musiksammlung scan back.jpg --vision -o album.json musiksammlung scan back.jpg --vision -o album.json