cue2auda/README.md

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

git clone <repository-url>
cd cue2auda

Oder einfach die Dateien herunterladen:

• cue2auda.py (Hauptscript)
• requirements.txt (optional)

Verwendung

python cue2auda.py /pfad/zu/ihren/cue/dateien

Beispiel

python cue2auda.py .

Verarbeitet alle .cue Dateien im aktuellen Verzeichnis.

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.