Installation

Installation

There are two ways to install: the prebuilt installer (recommended) or a manual install from source.

---

System requirements

Requirement	Value
Operating system	Windows 10 or Windows 11 (64 bit)
FFmpeg	Set up automatically by the installer
Python	Only for a manual install, version 3.10 or newer
Spotify developer account	Only for the Spotify downloader, free of charge

The installer sets MinVersion=10.0, so older Windows versions are rejected.

---

Option 1: Installer (recommended)

1. Download DeuMediaDownloader_Setup.exe for the latest version from the Releases page.
2. Run the setup. It requires administrator rights because it installs into C:\Program Files\DeuMediaDownloader.
3. Choose the setup language. This choice also sets the app language, it is written to %USERPROFILE%\.spotify_downloader\language as de or en.
4. Optionally tick the desktop icon.
5. At the end the setup checks whether FFmpeg is present. If it is missing, FFmpeg is installed automatically via winget install yt-dlp.FFmpeg.

The installer creates:

Location	Contents
C:\Program Files\DeuMediaDownloader\	DeuMediaDownloader.exe and the uninstaller
Start menu group DeuMediaDownloader	Shortcut and uninstall entry
Desktop	Shortcut, if selected
%USERPROFILE%\.spotify_downloader\	Language file, later configuration and token cache

---

Option 2: Manual install from source

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

Dependencies from requirements.txt:

Package	Purpose
customtkinter	User interface
spotipy	Spotify Web API
yt-dlp	Download core for all three sources
mutagen	Embedding metadata and cover art
requests	Downloading cover images
Pillow	Image processing for icons
aggdraw	Antialiasing during SVG rendering of the logos

On startup main.py checks whether customtkinter, spotipy, yt_dlp, mutagen and requests can be imported. If something is missing, a dialog shows the matching pip install command and the app exits. In the compiled EXE this check is skipped because all packages are bundled.

---

FFmpeg

FFmpeg is needed for format conversion, embedding thumbnails and subtitles, and for loudness normalization. Without FFmpeg the app only downloads the raw source format.

Automatic

The installer handles this. To do it manually afterwards:

winget install yt-dlp.FFmpeg

Manual

Download an archive from ffmpeg.org, extract it and add the bin folder to your PATH environment variable.

Where the app looks

converter.find_ffmpeg() searches in this order:

1. shutil.which("ffmpeg"), so anything on the PATH
2. %LOCALAPPDATA%\Microsoft\WinGet\Packages\ for folders containing ffmpeg in their name, including a recursive search for 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

A winget installation is therefore found even when it is not on the PATH.

Verify

ffmpeg -version

---

Uninstalling

Three ways:

1. In the app: open the settings and go to the "Uninstall & Cleanup" section. Three actions are available there:
   • Clear config data (removes %USERPROFILE%\.spotify_downloader)
   • Uninstall FFmpeg (winget uninstall yt-dlp.FFmpeg)
   • Uninstall DeuMediaDownloader (runs the uninstaller and closes the app)
2. Windows Settings: Apps, entry DeuMediaDownloader, Uninstall
3. Start menu: entry "Uninstall DeuMediaDownloader"

At the end the uninstaller additionally removes FFmpeg via winget and deletes the data folder %USERPROFILE%\.spotify_downloader completely.

---

Continue with Getting Started.