Files
fcco-Converter/README.md
T
2026-04-15 19:11:03 +02:00

70 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🎵 WAV zu MP3 Konverter
Ein einfaches, benutzerfreundliches Python-Tool mit grafischer Oberfläche (Tkinter), das WAV-Dateien in MP3-Dateien konvertiert. Es unterstützt automatische Metadaten-Erstellung (Künstler, Album, Titel, Tracknummer) und fügt sogar ein Cover-Bild ein. Alle Dateien werden automatisch alphabetisch sortiert.
---
## ✅ Features
- 📂 Mehrere WAV-Dateien auswählen
- 📝 Standard-Metadaten definieren (Künstler, Album, Cover)
- 🧠 Vorschau & Bearbeitung der Metadaten vor der Konvertierung
- 🔄 Automatische Sortierung nach Dateinamen
- 🖼️ Cover-Bild einfügen
- 💾 Einstellungen werden gespeichert (Metadaten & letzter Export-Ordner)
- 📊 Fortschrittsbalken während der Konvertierung
---
## 🛠️ Installation
Damit das Programm reibungslos funktioniert, gibt es Installationsskripte, die automatisch alle benötigten Komponenten (`Python`, virtuelle Umgebung, Abhängigkeiten sowie `FFmpeg`) für dein System herunterladen und einrichten.
### 🍏 macOS
1. Öffne ein Terminal und navigiere in das Verzeichnis deines Projekts, oder speziell in den `install` Ordner.
2. Mache das macOS Installationsskript ausführbar und führe es aus:
```bash
cd install
chmod +x install_macos.sh
./install_macos.sh
```
*Dieses Skript nutzt Homebrew, um `python` und `ffmpeg` zu installieren, erstellt eine isolierte virtuelle Umgebung und lädt die benötigten Python-Bibliotheken herunter.*
### 🪟 Windows
1. Wechsle in den Unterordner **`install`**.
2. Mach einen **Rechtsklick** auf die Datei **`install_windows.ps1`** und wähle **"Mit PowerShell ausführen"**.
*Dieses Skript prüft und installiert `python` und `ffmpeg` mithilfe von WinGet, erstellt dann eine virtuelle `.venv` und installiert die nötigen Pakete.*
---
## 🚀 Anwendung starten
Nach der erfolgreichen Installation, kannst du den Konverter immer kinderleicht starten:
- **Auf macOS:**
Führe **`start.sh`** aus dem Hauptverzeichnis aus. Entweder per Terminal (`./start.sh`) oder per Rechtsklick -> "Öffnen mit" -> "Terminal".
- **Auf Windows:**
Einfach einen Doppelklick auf die Datei **`start.bat`** im Hauptverzeichnis ausführen.
---
## 📁 Projektstruktur
📦 fcco-Converter
├── main.py # Hauptprogramm mit GUI
├── start.bat # Startskript für Windows
├── start.sh # Startskript für macOS
├── install/ # Installationsskripte
│ ├── install_windows.ps1
│ └── install_macos.sh
├── requirements.txt # Benötigte Python-Bibliotheken
└── README.md # Diese Datei
---
## ️ Hinweise
- Nur `.wav`-Dateien werden akzeptiert.
- Cover müssen eine `.jpg`- oder `.jpeg`-Datei sein.
- Export erfolgt im `.mp3`-Format, z.B. benannt nach dem Originaldateinamen.
- Metadaten können vor jeder Konvertierung überprüft und angepasst werden.