Installation

Installation

Es gibt zwei Wege: den fertigen Installer (empfohlen) oder die manuelle Installation aus dem Quellcode.

---

Systemvoraussetzungen

Anforderung	Wert
Betriebssystem	Windows 10 oder Windows 11 (64 Bit)
FFmpeg	Wird vom Installer automatisch eingerichtet
Python	Nur bei manueller Installation, ab Version 3.10
Spotify-Entwicklerkonto	Nur für den Spotify-Downloader, kostenlos

Der Installer setzt MinVersion=10.0, ältere Windows-Versionen werden abgelehnt.

---

Variante 1: Installer (empfohlen)

1. Auf der Releases-Seite die Datei DeuMediaDownloader_Setup.exe der neuesten Version herunterladen.
2. Setup ausführen. Die Installation benötigt Administratorrechte, da nach C:\Program Files\DeuMediaDownloader installiert wird.
3. Setup-Sprache wählen. Die Auswahl bestimmt gleichzeitig die Sprache der App, sie wird nach %USERPROFILE%\.spotify_downloader\language geschrieben (de oder en).
4. Optional das Desktop-Symbol anhaken.
5. Am Ende prüft das Setup, ob FFmpeg vorhanden ist. Fehlt es, wird es automatisch per winget install yt-dlp.FFmpeg nachinstalliert.

Der Installer legt an:

Ort	Inhalt
C:\Program Files\DeuMediaDownloader\	DeuMediaDownloader.exe und Uninstaller
Startmenü-Gruppe DeuMediaDownloader	Verknüpfung und Uninstall-Eintrag
Desktop	Verknüpfung, falls angehakt
%USERPROFILE%\.spotify_downloader\	Sprachdatei, später Konfiguration und Token-Cache

---

Variante 2: Manuell aus dem Quellcode

git clone https://github.com/EmilDeuOfficial/DeuMediaDownloader.git
cd DeuMediaDownloader
pip install -r requirements.txt
python main.py

Abhängigkeiten laut requirements.txt:

Paket	Zweck
customtkinter	Oberfläche
spotipy	Spotify-Web-API
yt-dlp	Download-Kern für alle drei Quellen
mutagen	Metadaten und Cover einbetten
requests	Cover-Bilder herunterladen
Pillow	Bildverarbeitung für Icons
aggdraw	Antialiasing beim SVG-Rendering der Logos

main.py prüft beim Start, ob customtkinter, spotipy, yt_dlp, mutagen und requests importierbar sind. Fehlt etwas, erscheint ein Dialog mit dem passenden pip install-Befehl und die App beendet sich. In der kompilierten EXE entfällt diese Prüfung, da alle Pakete eingebettet sind.

---

FFmpeg

FFmpeg wird für Formatkonvertierung, das Einbetten von Thumbnails und Untertiteln sowie für die Lautstärke-Normalisierung gebraucht. Ohne FFmpeg lädt die App nur das Rohformat der Quelle herunter.

Automatisch

Der Installer erledigt das. Manuell nachträglich:

winget install yt-dlp.FFmpeg

Manuell

Archiv von ffmpeg.org herunterladen, entpacken und den bin-Ordner in die PATH-Umgebungsvariable eintragen.

Wo die App sucht

converter.find_ffmpeg() sucht in dieser Reihenfolge:

1. shutil.which("ffmpeg"), also alles im PATH
2. %LOCALAPPDATA%\Microsoft\WinGet\Packages\ nach Ordnern, die ffmpeg im Namen tragen, inklusive rekursiver Suche nach ffmpeg.exe
3. C:\ffmpeg\bin\ffmpeg.exe
4. C:\Program Files\ffmpeg\bin\ffmpeg.exe
5. C:\Program Files (x86)\ffmpeg\bin\ffmpeg.exe

Eine winget-Installation wird also auch dann gefunden, wenn sie nicht im PATH steht.

Prüfen

ffmpeg -version

---

Deinstallation

Drei Wege:

1. In der App: Einstellungen öffnen, Reiter beziehungsweise Abschnitt "Deinstallation & Bereinigung". Dort gibt es drei Aktionen:
   • Konfigurationsdaten löschen (entfernt %USERPROFILE%\.spotify_downloader)
   • FFmpeg deinstallieren (winget uninstall yt-dlp.FFmpeg)
   • DeuMediaDownloader deinstallieren (startet den Uninstaller und schließt die App)
2. Windows-Einstellungen: Apps, Eintrag DeuMediaDownloader, Deinstallieren
3. Startmenü: Eintrag "Uninstall DeuMediaDownloader"

Der Uninstaller entfernt am Ende zusätzlich FFmpeg per winget und löscht den Datenordner %USERPROFILE%\.spotify_downloader vollständig.

---

Weiter mit Erste Schritte.