Musiksammlung/README.md
dschlueter 6c12510f76 Update docs for EAN-first workflow and genre field
- README: mention EAN-first auto-rip in quickstart
- BEDIENUNGSANLEITUNG: rewrite workflow diagram and interactive example
  for EAN-first flow (auto-rip on MB hit, fallback on miss), document
  genre field in album.json, update multi-disc and tips sections

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 00:25:08 +01:00

50 lines
1.2 KiB
Markdown

# Musiksammlung
> **ACHTUNG! Das Programm ist nicht fertig!**
CLI-Tool zum Digitalisieren von CD-Sammlungen für Jellyfin.
## Überblick
**Musiksammlung** automatisiert die Digitalisierung physischer CDs:
1. CDs rippen (via `abcde`, CDDB-Lookup)
2. Coverbilder per OCR oder Vision-LLM analysieren
3. Tracklisten per LLM extrahieren und als JSON speichern
4. Audiodateien umbenennen, taggen und in Jellyfin-Struktur ablegen
5. M3U-Playlisten erzeugen
## Voraussetzungen
- Python 3.11+
- `abcde` (CD-Ripping)
- `tesseract` (OCR, optional)
- Ollama oder OpenAI-kompatibles LLM (optional)
## Installation
```bash
pip install -e ".[dev]"
```
## Schnellstart
```bash
# CDs rippen (interaktiv, EAN-First: MusicBrainz → Auto-Rip bei Treffer)
musiksammlung rip -j 0 -P
# 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
```
Ausführliche Anleitung: [BEDIENUNGSANLEITUNG.md](BEDIENUNGSANLEITUNG.md)
## Lizenz
Siehe [LICENSE](LICENSE).