v1.4.0

.gitnore

@@ -1,3 +1,4 @@
 .DS_Store
 Cover/*
-App
+App
+.venv

README.md

@@ -1,62 +1,70 @@
-# 🎵 WAV zu MP3 Konverter
+# 🎵 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.
+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
+## ✅ Features
-
+
-- 📂 Mehrere WAV-Dateien auswählen
+- 📂 Mehrere WAV-Dateien auswählen
-- 📝 Standard-Metadaten definieren (Künstler, Album, Cover)
+- 📝 Standard-Metadaten definieren (Künstler, Album, Cover)
-- 🧠 Vorschau & Bearbeitung der Metadaten vor der Konvertierung
+- 🧠 Vorschau & Bearbeitung der Metadaten vor der Konvertierung
-- 🔄 Automatische Sortierung nach Dateinamen
+- 🔄 Automatische Sortierung nach Dateinamen
-- 🖼️ Cover-Bild einfügen
+- 🖼️ Cover-Bild einfügen
-- 💾 Einstellungen werden gespeichert (Metadaten & letzter Export-Ordner)
+- 💾 Einstellungen werden gespeichert (Metadaten & letzter Export-Ordner)
-- 📊 Fortschrittsbalken während der Konvertierung
+- 📊 Fortschrittsbalken während der Konvertierung
-
+
----
+---
-
+
-## 🛠️ Setup
+## 🛠️ Installation
-
+
-# Automatisches Setup starten
+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.
-Windows-Nutzer können einfach ````setup.bat````` ausführen – es installiert:
+
--	Python (falls nicht vorhanden)
+### 🍏 macOS
--	Virtuelle Umgebung
+1. Öffne ein Terminal und navigiere in das Verzeichnis deines Projekts, oder speziell in den `install` Ordner.
--	Alle benötigten Python-Pakete (pydub, mutagen)
+2. Mache das macOS Installationsskript ausführbar und führe es aus:
--	FFmpeg (wird automatisch heruntergeladen & eingebunden)
+   ```bash
-
+   cd install
-# Alternativ: Manuell installieren
+   chmod +x install_macos.sh
-1. Stelle sicher, dass Python 3.11 oder neuer installiert ist.
+   ./install_macos.sh
-2. Virtuelle Umgebung erstellen und aktivieren:
+   ```
-````python -m venv .venv
+   *Dieses Skript nutzt Homebrew, um `python` und `ffmpeg` zu installieren, erstellt eine isolierte virtuelle Umgebung und lädt die benötigten Python-Bibliotheken herunter.*
-.venv\Scripts\activate````
+
-
+### 🪟 Windows
-3. Abhängigkeiten installieren:
+1. Wechsle in den Unterordner **`install`**.
-`````pip install pydub mutagen````
+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.*
-4. FFmpeg herunterladen und den bin-Ordner zur PATH-Umgebungsvariable hinzufügen.
+
-
+---
-# 🚀 Anwendung starten
+
-1. main.py ausführen:
+## 🚀 Anwendung starten
-````.venv\Scripts\python.exe main.py````
+
-
+Nach der erfolgreichen Installation, kannst du den Konverter immer kinderleicht starten:
-2. WAV-Dateien auswählen und konvertieren.
+
-
+- **Auf macOS:**
-
+  Führe **`start.sh`** aus dem Hauptverzeichnis aus. Entweder per Terminal (`./start.sh`) oder per Rechtsklick -> "Öffnen mit" -> "Terminal".
-#📁 Projektstruktur
+
-
+- **Auf Windows:**
-📦 wav-to-mp3-converter
+  Einfach einen Doppelklick auf die Datei **`start.bat`** im Hauptverzeichnis ausführen.
-├── setup.bat              # Batch-Datei zum Starten der Installation
+
-├── setup.ps1              # PowerShell-Setupscript
+---
-├── settings.json          # Gespeicherte Einstellungen (automatisch erzeugt)
+
-├── main.py                # Hauptprogramm mit GUI
+## 📁 Projektstruktur
-└── README.md              # Diese Datei
+
-
+📦 fcco-Converter
-#ℹ️ Hinweise
+├── main.py                # Hauptprogramm mit GUI
-Nur .wav-Dateien werden akzeptiert.
+├── start.bat              # Startskript für Windows
-
+├── start.sh               # Startskript für macOS
-Cover muss eine .jpg- oder .jpeg-Datei sein.
+├── install/               # Installationsskripte
-
+│   ├── install_windows.ps1
-Export erfolgt im .mp3-Format, benannt nach dem Originaldateinamen.
+│   └── install_macos.sh
-
+├── requirements.txt       # Benötigte Python-Bibliotheken
-Metadaten können vor jeder Konvertierung überprüft und angepasst werden.
+└── 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.

install/install_macos.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+echo "Starte macOS Installation für fcco-Converter..."
+
+# Ins Root-Verzeichnis wechseln
+cd "$(dirname "$0")/.."
+
+# Prüfe Homebrew
+if ! command -v brew &> /dev/null; then
+    echo "Homebrew ist nicht installiert. Installiere Homebrew..."
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+fi
+
+# Installiere Abhängigkeiten via Homebrew
+echo "Installiere Python und FFmpeg falls nötig..."
+brew install python ffmpeg python-tk@3.11
+
+# Virtuelle Umgebung erstellen
+if [ ! -d ".venv" ]; then
+    echo "Erstelle virtuelle Umgebung..."
+    python3 -m venv .venv
+fi
+
+# Pakete installieren
+echo "Installiere Python-Pakete..."
+source .venv/bin/activate
+pip install --upgrade pip
+pip install -r requirements.txt
+
+echo "==================="
+echo "Installation abgeschlossen!"
+echo "Du kannst das Programm nun mit einem Doppelklick auf 'start.sh' im Hauptordner starten,"
+echo "oder im Terminal './start.sh' ausführen."
+echo "==================="

install/install_windows.ps1

@@ -0,0 +1,37 @@
+Write-Host "Starte Windows Installation für fcco-Converter..." -ForegroundColor Cyan
+
+# Ins Root-Verzeichnis wechseln
+$PSScriptRoot = Split-Path -Parent -Path $MyInvocation.MyCommand.Definition
+Set-Location -Path "$PSScriptRoot\.."
+
+Write-Host "Überprüfe FFmpeg..." -ForegroundColor Yellow
+if (Get-Command ffmpeg -ErrorAction SilentlyContinue) {
+    Write-Host "FFmpeg ist bereits installiert." -ForegroundColor Green
+} else {
+    Write-Host "Installiere FFmpeg via winget..." -ForegroundColor Yellow
+    winget install --id "Gyan.FFmpeg" --accept-package-agreements --accept-source-agreements
+}
+
+Write-Host "Überprüfe Python..." -ForegroundColor Yellow
+if (-not (Get-Command python -ErrorAction SilentlyContinue)) {
+    Write-Host "Python ist nicht installiert. Installiere Python via winget..." -ForegroundColor Yellow
+    winget install --id "Python.Python.3.11" --accept-package-agreements --accept-source-agreements
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+} else {
+    Write-Host "Python ist bereits installiert." -ForegroundColor Green
+}
+
+if (-not (Test-Path ".venv")) {
+    Write-Host "Erstelle virtuelle Umgebung (.venv)..." -ForegroundColor Yellow
+    python -m venv .venv
+}
+
+Write-Host "Installiere Python-Pakete..." -ForegroundColor Yellow
+& .\.venv\Scripts\python.exe -m pip install --upgrade pip
+& .\.venv\Scripts\python.exe -m pip install -r requirements.txt
+
+Write-Host "===================" -ForegroundColor Cyan
+Write-Host "Installation abgeschlossen!" -ForegroundColor Green
+Write-Host "Du kannst das Programm nun mit einem Doppelklick auf 'start.bat' im Hauptordner starten." -ForegroundColor White
+Write-Host "===================" -ForegroundColor Cyan
+Pause

main.py

@@ -61,8 +61,14 @@ except:
 
 settings = load_settings()
 
+def set_window_icon(window):
+    try:
+        window.iconbitmap("icon.ico")
+    except Exception:
+        pass
+
 root = Tk()
-root.iconbitmap("icon.ico")
+set_window_icon(root)
 root.title("fcco Converter")
 root.geometry("800x1200")
 
@@ -134,7 +140,7 @@ def extract_event_from_folder(file_path):
 
 def open_settings_window():
     win = Toplevel(root)
-    win.iconbitmap("icon.ico")
+    set_window_icon(win)
     win.title("Einstellungen")
     win.geometry("500x600")
 
@@ -200,7 +206,7 @@ def confirm_metadata_and_type():
     meta["year"] = str(datetime.now().year)
 
     win = Toplevel(root)
-    win.iconbitmap("icon.ico")
+    set_window_icon(win)
     win.title("Metadaten und Exportoptionen")
     win.geometry("650x650")
 
@@ -422,7 +428,7 @@ def convert():
 
         # Custom completion popup with "OK" and "Programm schließen"
         win = Toplevel(root)
-        win.iconbitmap("icon.ico")
+        set_window_icon(win)
         win.title("Konvertierung abgeschlossen")
         win.geometry("300x150")
         Label(win, text="Konvertierung abgeschlossen!", font=("Arial", 12)).pack(pady=20)

requirements.txt

@@ -1,4 +1,2 @@
 pydub
-mutagen
+mutagen
-tkinter
-datetime

run.bat

@@ -1,3 +0,0 @@
-@echo off
-start /min python main.py
-exit

start.bat

@@ -1,6 +1,11 @@
 @echo off
-REM Stelle sicher, dass Python 3.11 in deinem PATH ist oder gib den vollständigen Pfad an.
+cd /d "%~dp0"
-python3.11 main.py
 
-REM Optional: Das Fenster bleibt offen, damit du eventuelle Fehlermeldungen sehen kannst.
+IF NOT EXIST ".venv" (
-pause
+    echo Die virtuelle Umgebung fehlt.
+    echo Bitte fuehre zuerst die Installation (install\install_windows.ps1) aus!
+    pause
+    exit /b
+)
+
+start "" /B ".venv\Scripts\pythonw.exe" main.py

start.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+cd "$(dirname "$0")"
+
+if [ ! -d ".venv" ]; then
+    echo "Die virtuelle Umgebung fehlt."
+    echo "Bitte führe zuerst die Installation (install/install_macos.sh) aus!"
+    exit 1
+fi
+
+source .venv/bin/activate
+python3 main.py