95 lines
2.7 KiB
Markdown
95 lines
2.7 KiB
Markdown
# 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. |