From 223fa6ab0c232efc7eaedab76edaf91bf9f5c8ba Mon Sep 17 00:00:00 2001
From: Manuel Weiser <manuel.weiser@me.com>
Date: Thu, 3 Jul 2025 10:21:58 +0200
Subject: [PATCH] =?UTF-8?q?F=C3=BCge=20README.md=20hinzu:=20Dokumentation?=
 =?UTF-8?q?=20f=C3=BCr=20CUE=20zu=20Audacity=20Label=20Converter?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 112 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 112 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..31576a3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,112 @@
+# CUE to Audacity Label Converter
+
+Ein Python-Script, das CUE-Dateien (von rekordbox DJ oder anderen Quellen) in Audacity-Label-Dateien umwandelt.
+
+## Beschreibung
+
+Dieses Tool liest CUE-Dateien und erstellt daraus Textdateien mit Zeitstempeln und Track-Titeln, die direkt in Audacity als Label-Track importiert werden können. 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)
+- 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
+
+```bash
+python cue2auda.py /pfad/zu/ihren/cue/dateien
+```
+
+### Beispiel
+```bash
+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
+```
+
+## 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 `.txt` Datei aus
+4. Die Zeitmarken erscheinen als Label-Track
+
+## Dateien
+
+- `cue2auda.py` - Hauptscript
+- `requirements.txt` - Python-Abhängigkeiten (leer, da nur Standard-Bibliotheken verwendet werden)
+- `README.md` - Diese Datei
+
+## 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. Importieren Sie die generierte `.txt` Datei in Audacity
+4. Nutzen Sie die Labels zum Schneiden oder Navigieren
+
+## 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.