Musiksammlung/README.md

# 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. Backcover automatisch via Smartphone-Upload erfassen
3. Backcover per Vision-LLM parallel zum Ripping analysieren (Cloud-Modell, kein lokales VRAM nötig)
4. Coverbilder per OCR oder Vision-LLM analysieren
5. Tracklisten per LLM extrahieren und als JSON speichern
6. Audiodateien umbenennen, taggen und in Jellyfin-Struktur ablegen
7. M3U-Playlisten erzeugen

## Voraussetzungen

- Python 3.11+
- `abcde` (CD-Ripping)
- `tesseract` (OCR, optional)
- Ollama oder OpenAI-kompatibles LLM (optional)
- Firewall: Port 8765 (TCP) für Smartphone-Upload offen (`sudo ufw allow 8765/tcp`)

## Installation

```bash
pip install -e ".[dev]"
```

## Schnellstart

```bash
# CDs rippen (interaktiv, EAN-First: MusicBrainz → Auto-Rip bei Treffer)
# QR-Code im Terminal: Backcover mit Smartphone fotografieren → Vision-LLM analysiert parallel
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).