feat: smart title extraction from filename for 2.0.2

2026-07-20 18:29:58 +02:00
parent 87b5ba91b1
commit c486339f8d
5 changed files with 71 additions and 50 deletions
@@ -1,6 +1,6 @@
 # fcco Converter V2

-WAV-zu-MP3-Konverter mit grafischer Benutzeroberfläche. Unterstützt automatische Metadaten-Erstellung (Künstler, Album, Titel, Tracknummer), Cover-Bilder und alphabetische Sortierung. Läuft auf **Windows** und **macOS**.
+WAV-zu-MP3-Konverter mit grafischer Benutzeroberfläche. Unterstützt automatische Metadaten-Erstellung (Künstler, Album, Titel, Tracknummer), Cover-Bilder und alphabetische Sortierung. Läuft auf Windows und macOS.

 ---

@@ -13,16 +13,33 @@ WAV-zu-MP3-Konverter mit grafischer Benutzeroberfläche. Unterstützt automatisc
 - Einstellungen werden dauerhaft gespeichert
 - Fortschrittsanzeige pro Datei und gesamt
 - Automatisches Update direkt aus der App
- Moderne, dunkle Benutzeroberfläche (CustomTkinter)
+- Moderne, dunkle Benutzeroberfläche
+
+---
+
+## Automatische Titel-Extrahierung (Neu in V2.0.2)
+
+Das Programm erkennt Dateinamen im typischen fcco-Format und erstellt daraus automatisch saubere Songtitel (ID3-Tags). 
+Das Muster wird nach dem Unterstrich-Format extrahiert. Hier sind Beispiele, wie aus Dateinamen automatisch MP3-Titel gebildet werden:
+
+- 260719So_N_10_Predigt_D Vorname Nachname.wav -> "Predigt Vorname Nachname"
+- 260719So_N_07_Vorwort_D Vorname Nachname.wav -> "Vorwort Vorname Nachname"
+- 260719So_N_09_Gedicht_D Vorname Nachname.wav -> "Gedicht Vorname Nachname"
+- 260719So_N_10_Predigt_D.wav -> "Predigt D"
+- 260719So_N_10_Predigt_D Gast.wav -> "Predigt Gast"
+- 260719So_N_06_Lied_R О пройденном я подвожу итог.wav -> "О пройденном я подвожу итог"
+- 260719So_N_04_Lied_D Zum blauen Himmel.wav -> "Zum blauen Himmel"
+- 260719So_N_04_Chor_D Zum blauen Himmel.wav -> "Zum blauen Himmel (Chor)"
+- 260719So_N_04_Orchester_D Zum blauen Himmel.wav -> "Zum blauen Himmel (Orchester)"

 ---

 ## Installation (Endnutzer)

-Lade die neueste Version von der [Releases-Seite](https://git.joelunger.de/public/fcco-Converter/releases) herunter:
+Lade die neueste Version von der Releases-Seite (Gitea) herunter:

- **Windows**: `fcco-Converter-windows.zip` entpacken und `fcco-Converter.exe` starten.
- **macOS**: `fcco-Converter-macos.zip` entpacken und `fcco-Converter` starten.
+- Windows: fcco-Converter-windows.zip entpacken und fcco-Converter.exe starten.
+- macOS: fcco-Converter-macos.zip entpacken und fcco-Converter starten.

 FFmpeg wird automatisch beim ersten Start heruntergeladen. Keine weitere Installation nötig.

@@ -30,66 +47,27 @@ FFmpeg wird automatisch beim ersten Start heruntergeladen. Keine weitere Install

 ## Updates

-In der App auf **"Update prüfen"** klicken. Wenn eine neue Version verfügbar ist, wird sie direkt heruntergeladen und installiert. Danach muss die App einmal neu gestartet werden.
+In der App auf "Update prüfen" klicken. Wenn eine neue Version verfügbar ist, wird sie direkt heruntergeladen und installiert. Danach muss die App einmal neu gestartet werden.

 ---

 ## Entwicklung

 ### Voraussetzungen
-
 - Python 3.11 oder neuer
 - Virtuelle Umgebung empfohlen

 ### Setup
-
-```bash
 python -m venv .venv
 source .venv/bin/activate    # macOS / Linux
 # .venv\Scripts\activate     # Windows

 pip install -r requirements.txt
-```

 ### Starten
-
-```bash
 python main.py
-```

-### Build (Standalone-Executable)
-
-```bash
+### Build (Standalone-Executable & ZIP-Erstellung)
 python build.py
-```

-Die fertige Datei liegt anschließend im `dist/`-Verzeichnis.
-
---
-
-## Projektstruktur
-
-```
-fcco-Converter/
-├── main.py                       # Einstiegspunkt
-├── build.py                      # Build-Skript (PyInstaller)
-├── requirements.txt              # Abhängigkeiten
-├── icon.ico                      # Programm-Icon
-├── fcco_converter/
-│   ├── __init__.py
-│   ├── config.py                 # Einstellungen & Konfiguration
-│   ├── converter.py              # FFmpeg-Konvertierung
-│   ├── metadata.py               # ID3-Tags & Cover
-│   ├── updater.py                # Auto-Update von Gitea Releases
-│   └── gui.py                    # CustomTkinter GUI
-└── README.md
-```
-
---
-
-## Hinweise
-
- Nur `.wav`-Dateien werden als Eingabe akzeptiert.
- Cover-Bilder müssen `.jpg`, `.jpeg` oder `.png` sein.
- Export erfolgt im `.mp3`-Format (192 kbit/s).
- Einstellungen werden in `~/.config/fcco-Converter/` (Linux), `~/Library/Application Support/fcco-Converter/` (macOS) bzw. `%APPDATA%/fcco-Converter/` (Windows) gespeichert.
+Die fertige App und die Release-ZIP-Datei liegen anschließend im dist/ Verzeichnis.