156 lines
4.4 KiB
Markdown
156 lines
4.4 KiB
Markdown
# CUE to Audacity Label Converter
|
|
|
|
Ein Python-Script, das CUE-Dateien (von rekordbox DJ oder anderen Quellen) in Audacity-Label-Dateien und schöne Tracklists umwandelt.
|
|
|
|
## Beschreibung
|
|
|
|
Dieses Tool liest CUE-Dateien und erstellt daraus zwei Ausgabe-Dateien:
|
|
1. **Audacity-Labels**: Textdateien mit Zeitstempeln für den Import in Audacity
|
|
2. **Tracklist**: Professionell formatierte Trackliste zum Teilen
|
|
|
|
Besonders nützlich für DJ-Sets oder lange Audio-Aufnahmen, die in einzelne Tracks unterteilt werden sollen.
|
|
|
|
## Features
|
|
|
|
- Unterstützt rekordbox CUE-Dateien im HH:MM:SS Format
|
|
- Automatische Erkennung von Standard CUE-Formaten (MM:SS:FF mit CD-Frames)
|
|
- **Intelligente Duplikat-Filterung**: Entfernt Tracks, die innerhalb der letzten 2 Tracks bereits vorkamen
|
|
- **Zwei Ausgabe-Formate**: Audacity-Labels und professionelle Tracklist
|
|
- Flexible Regex-Pattern für verschiedene Einrückungen (Tabs/Leerzeichen)
|
|
- UTF-8 Encoding für internationale Zeichen
|
|
- Plattformübergreifend (Windows, macOS, Linux)
|
|
|
|
## Installation
|
|
|
|
### Voraussetzungen
|
|
- Python 3.6 oder höher
|
|
- Keine externen Abhängigkeiten (nutzt nur Standard-Bibliotheken)
|
|
|
|
### Setup
|
|
```bash
|
|
git clone <repository-url>
|
|
cd cue2auda
|
|
```
|
|
|
|
Oder einfach die Dateien herunterladen:
|
|
- `cue2auda.py` (Hauptscript)
|
|
- `requirements.txt` (optional)
|
|
|
|
## Verwendung
|
|
|
|
Das Script unterstützt zwei Modi:
|
|
|
|
### 1. Verzeichnis verarbeiten (alle CUE-Dateien)
|
|
|
|
```bash
|
|
python cue2auda.py /pfad/zu/ihren/cue/dateien
|
|
```
|
|
|
|
### 2. Einzelne CUE-Datei verarbeiten
|
|
|
|
```bash
|
|
python cue2auda.py /pfad/zur/datei.cue
|
|
```
|
|
|
|
### Beispiele
|
|
|
|
```bash
|
|
# Alle CUE-Dateien im aktuellen Verzeichnis verarbeiten
|
|
python cue2auda.py .
|
|
|
|
# Alle CUE-Dateien in einem spezifischen Verzeichnis
|
|
python cue2auda.py /Users/manuel/Music/DJ-Sets/
|
|
|
|
# Nur eine spezifische CUE-Datei verarbeiten
|
|
python cue2auda.py "01 REC-2025-07-02.cue"
|
|
|
|
# Absolute Pfad zu einer einzelnen Datei
|
|
python cue2auda.py /Users/manuel/Music/mix.cue
|
|
```
|
|
|
|
## Ein- und Ausgabeformat
|
|
|
|
### Eingabe (CUE-Datei)
|
|
```
|
|
TRACK 01 AUDIO
|
|
TITLE "Song Title"
|
|
PERFORMER "Artist Name"
|
|
INDEX 01 00:02:30
|
|
```
|
|
|
|
### Ausgabe (TXT-Datei für Audacity)
|
|
```
|
|
150.000000 150.000000 Song Title
|
|
```
|
|
|
|
### Ausgabe (Tracklist-Datei)
|
|
```
|
|
01. Artist Name - Song Title (02:30)
|
|
02. Another Artist - Another Song (05:15)
|
|
```
|
|
|
|
## Unterstützte CUE-Formate
|
|
|
|
1. **rekordbox Format**: `HH:MM:SS` (Stunden:Minuten:Sekunden)
|
|
2. **Standard CUE Format**: `MM:SS:FF` (Minuten:Sekunden:Frames, 75 Frames pro Sekunde)
|
|
|
|
Das Script erkennt automatisch das Format basierend auf den Zeitwerten.
|
|
|
|
## Audacity Import
|
|
|
|
1. Öffnen Sie Ihre Audio-Datei in Audacity
|
|
2. Gehen Sie zu `Datei` → `Importieren` → `Labels...`
|
|
3. Wählen Sie die generierte `*_audacity.txt` Datei aus
|
|
4. Die Zeitmarken erscheinen als Label-Track
|
|
|
|
## Ausgabedateien
|
|
|
|
Das Script erstellt automatisch zwei Dateien:
|
|
|
|
- `filename_audacity.txt` - Audacity-Label-Datei für den Import
|
|
- `filename_tracklist.txt` - Professionelle Tracklist zum Teilen
|
|
|
|
## Beispiel-Workflow
|
|
|
|
1. Exportieren Sie ein DJ-Set aus rekordbox mit CUE-Datei
|
|
2. Führen Sie das Script aus: `python cue2auda.py /pfad/zu/cue/dateien`
|
|
3. **Zwei Dateien werden erstellt:**
|
|
- `filename_audacity.txt` → Importieren Sie diese in Audacity als Labels
|
|
- `filename_tracklist.txt` → Teilen Sie diese schöne Tracklist
|
|
4. Nutzen Sie die Labels zum Schneiden oder Navigieren in Audacity
|
|
|
|
## Duplikat-Filterung
|
|
|
|
Das Script erkennt automatisch Duplikate in DJ-Mixes und filtert Tracks heraus, die innerhalb der letzten 2 Tracks bereits vorkamen. Dies ist besonders nützlich bei:
|
|
|
|
- **Blend-Übergängen**: Wenn Tracks überlappend gespielt werden
|
|
- **Loop-Rolls**: Wenn derselbe Track kurz wiederholt wird
|
|
- **DJ-Techniken**: Drop-outs, Cuts und Re-Entries
|
|
|
|
## Technische Details
|
|
|
|
- **Zeitformat**: Absolute Zeitstempel in Sekunden vom Anfang der Aufnahme
|
|
- **Encoding**: UTF-8 für internationale Zeichen
|
|
- **Kompatibilität**: Funktioniert mit Tab- und Leerzeichen-Einrückung
|
|
|
|
## Fehlerbehebung
|
|
|
|
### Leere Ausgabedatei
|
|
- Überprüfen Sie das Format Ihrer CUE-Datei
|
|
- Stellen Sie sicher, dass `TITLE` und `INDEX 01` Zeilen vorhanden sind
|
|
|
|
### Falsche Zeitstempel
|
|
- Das Script erkennt automatisch HH:MM:SS vs MM:SS:FF Format
|
|
- Bei Problemen überprüfen Sie die Debug-Ausgaben
|
|
|
|
## Autor
|
|
|
|
Manuel Weiser
|
|
Datum: 2025-07-03
|
|
|
|
Basierend auf dem ursprünglichen Script von Fabrice Baro (2019-10-24)
|
|
|
|
## Lizenz
|
|
|
|
Frei verfügbar für persönliche und kommerzielle Nutzung.
|