Add --except PATTERN option and update documentation

- --except filters albums by directory name (glob or substring, repeatable)
- README.md: new options table entries, new cover sources, updated pipeline,
  corrected test count (33), added batch example
- BEDIENUNGSANLEITUNG.md: new options table, sections E (batch+except),
  F (--status), LASTFM_API_KEY env var, corrected test count

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Dieter Schlüter 2026-04-29 11:38:52 +02:00
commit 0ca05e91d4
3 changed files with 77 additions and 9 deletions

View file

@ -98,6 +98,9 @@ python3 ~/nvme2n1p7_home/Musik/Music_Metadata_Enricher/music_enricher.py \
| `--no-api` | Keine externen Zugriffe (MusicBrainz, OCR, YouTube) |
| `--no-cover` | Kein Cover-Art-Download |
| `--no-tqdm` | Fortschrittsbalken deaktivieren |
| `--status` | Bibliotheksstatus anzeigen (fehlende Cover, schlechte Tags) — nichts schreiben |
| `--skip-complete` | Alben überspringen, die bereits Cover + gute Tags haben |
| `--except PATTERN` | Album ausschließen, dessen Verzeichnisname das Muster enthält (Glob oder Substring, mehrfach verwendbar) |
---
@ -156,7 +159,33 @@ python3 ~/nvme2n1p7_home/Musik/Music_Metadata_Enricher/music_enricher.py \
Alben mit Konfidenz unter 0.85 werden übersprungen und müssen manuell
mit `--album` und niedrigerem `--confidence`-Wert bearbeitet werden.
### E) Interaktiver Modus (ohne --auto)
### E) Batch-Lauf mit Ausschlüssen und Überspringen bereits fertiger Alben
```bash
python3 ~/nvme2n1p7_home/Musik/Music_Metadata_Enricher/music_enricher.py \
--auto --confidence 0.5 --rename --embed-cover --no-fingerprint \
--skip-complete \
--except 'Eigene_Aufnahmen*' \
--except Hoerbuch \
--backup /tmp/backup \
~/nvme2n1p7_home/Musik
```
- `--skip-complete` überspringt Alben, die bereits Cover und gute Tags haben.
- `--except` schließt Alben anhand des Verzeichnisnamens aus.
Glob-Muster (`*`, `?`) und einfache Substrings werden beide unterstützt.
Die Option kann mehrfach angegeben werden.
### F) Bibliotheksstatus anzeigen
```bash
python3 ~/nvme2n1p7_home/Musik/Music_Metadata_Enricher/music_enricher.py \
--status ~/nvme2n1p7_home/Musik
```
Zeigt alle Alben mit fehlenden Covern oder schlechten Tags — ohne etwas zu schreiben.
### G) Interaktiver Modus (ohne --auto)
```bash
python3 ~/nvme2n1p7_home/Musik/Music_Metadata_Enricher/music_enricher.py \
@ -251,13 +280,16 @@ export OLLAMA_OCR_MODEL=qwen3-vl:latest # Vision-Modell für OCR
export OPENROUTER_API_KEY=sk-or-... # OpenRouter-Fallback (optional)
export ACOUSTID_API_KEY=... # AcoustID-Fingerprinting (optional)
export DISCOGS_TOKEN=... # Discogs-API (optional)
export LASTFM_API_KEY=... # Last.fm Cover + Tracklist (optional)
```
Kostenloser Last.fm API-Key: https://www.last.fm/api/account/create
---
## Tests ausführen
```bash
python3 ~/nvme2n1p7_home/Musik/Music_Metadata_Enricher/test_suite_enricher.py
# 📊 17/17 Tests erfolgreich
# 📊 33/33 Tests erfolgreich
```