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

---

## Features

- Mehrere WAV-Dateien oder ganze Ordner (mit Unterordnern) auswählen
- Metadaten definieren und bearbeiten (Künstler, Album, Jahr, Cover)
- Automatische Sortierung nach Dateinamen
- Cover-Bild einfügen (JPG/PNG)
- Einstellungen werden dauerhaft gespeichert
- Fortschrittsanzeige pro Datei und gesamt
- Automatisches Update direkt aus der App
- Moderne, dunkle Benutzeroberfläche (CustomTkinter)

---

## Installation (Endnutzer)

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

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

---

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

---

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