dschlueter
8e46c46263
- 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>
57 lines
1.7 KiB
Markdown
57 lines
1.7 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. 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 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
|
|
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).
|