v1.4.0
This commit is contained in:
joel
@@ -1,62 +1,70 @@
|
||||
# 🎵 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
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Setup
|
||||
|
||||
# Automatisches Setup starten
|
||||
Windows-Nutzer können einfach ````setup.bat````` ausführen – es installiert:
|
||||
- Python (falls nicht vorhanden)
|
||||
- Virtuelle Umgebung
|
||||
- Alle benötigten Python-Pakete (pydub, mutagen)
|
||||
- FFmpeg (wird automatisch heruntergeladen & eingebunden)
|
||||
|
||||
# Alternativ: Manuell installieren
|
||||
1. Stelle sicher, dass Python 3.11 oder neuer installiert ist.
|
||||
2. Virtuelle Umgebung erstellen und aktivieren:
|
||||
````python -m venv .venv
|
||||
.venv\Scripts\activate````
|
||||
|
||||
3. Abhängigkeiten installieren:
|
||||
`````pip install pydub mutagen````
|
||||
|
||||
4. FFmpeg herunterladen und den bin-Ordner zur PATH-Umgebungsvariable hinzufügen.
|
||||
|
||||
# 🚀 Anwendung starten
|
||||
1. main.py ausführen:
|
||||
````.venv\Scripts\python.exe main.py````
|
||||
|
||||
2. WAV-Dateien auswählen und konvertieren.
|
||||
|
||||
|
||||
#📁 Projektstruktur
|
||||
|
||||
📦 wav-to-mp3-converter
|
||||
├── setup.bat # Batch-Datei zum Starten der Installation
|
||||
├── setup.ps1 # PowerShell-Setupscript
|
||||
├── settings.json # Gespeicherte Einstellungen (automatisch erzeugt)
|
||||
├── main.py # Hauptprogramm mit GUI
|
||||
└── README.md # Diese Datei
|
||||
|
||||
#ℹ️ Hinweise
|
||||
Nur .wav-Dateien werden akzeptiert.
|
||||
|
||||
Cover muss eine .jpg- oder .jpeg-Datei sein.
|
||||
|
||||
Export erfolgt im .mp3-Format, benannt nach dem Originaldateinamen.
|
||||
|
||||
Metadaten können vor jeder Konvertierung überprüft und angepasst werden.
|
||||
# 🎵 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.
|
||||
Reference in New Issue
Block a user