# 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.