Getting Started

Getting Started

After installation the app opens with the launcher, where you pick which downloader you want to use.

---

The launcher

A window of 720 by 360 pixels with three cards:

Card	Description	Color
Spotify	Tracks, playlists and albums	Green #1DB954
YouTube	Videos and playlists	Red #CC2222
TikTok	Videos and audio	Pink #EE1D52

The window position is remembered (launcher_pos in the configuration). If you leave a downloader through the back arrow you return to the launcher. If you close it with the X the app exits completely.

---

Setting up Spotify API credentials

The YouTube and TikTok downloaders work right away. The Spotify downloader needs your own API credentials once, because the app reads title, artist, album, year, duration and cover art through the official Spotify Web API.

Step 1: Create an app in the Spotify dashboard

1. Open developer.spotify.com/dashboard and sign in with your regular Spotify account. A free account is enough.
2. Click Create app.
3. Name and description are up to you, for example DeuMediaDownloader.
4. Enter this exact Redirect URI:

http://127.0.0.1:8888/callback

5. Select the Web API, accept the terms and save.
6. Copy Client ID and Client Secret from the app settings.

The redirect URI has to match character for character. The app uses http://127.0.0.1:8888/callback, not localhost.

Step 2: Enter the credentials in the app

1. Open the Spotify downloader.
2. Click the gear icon in the top right.
3. Paste Client ID and Client Secret.
4. Click Save.

The log then shows "Spotify client initialised". The settings also contain a button that opens the developer dashboard directly and a field from which the redirect URI can be copied.

Step 3: Authorization in the browser

On first access your browser opens the Spotify login. After you confirm, a token is written to %USERPROFILE%\.spotify_downloader\.spotify_token_cache and reused from then on. The scope is limited to playlist-read-private playlist-read-collaborative, so read access to your playlists only.

---

Your first download

Using Spotify as the example:

1. In Spotify, right-click a track, album or playlist and copy the link.
2. Click Paste in the downloader or insert the URL manually.
3. Choose a format, for example MP3 (320 kbps). See Formats and Quality.
4. Set an output folder with Browse. The default is %USERPROFILE%\Music\Spotify Downloads.
5. Click Download.

What happens next:

Resolve URL  ->  fill the queue  ->  for each track:
    Searching     find the best matching YouTube result by duration
    Downloading   fetch the audio via yt-dlp
    Converting    FFmpeg converts to the selected format
    Embedding     mutagen writes title, artist, album, year and cover art
    Done

The queue shows a progress bar and the current status for each entry, the log panel below shows all messages. Clear Done removes finished entries.

---

Supported URL forms

Downloader	Examples
Spotify	https://open.spotify.com/track/..., /playlist/..., /album/... and spotify:track:...
Spotify (bonus)	YouTube URLs are also accepted in the Spotify window
YouTube	https://www.youtube.com/watch?v=..., https://youtu.be/..., .../playlist?list=...
TikTok	https://www.tiktok.com/@name/video/..., /@name, /tag/..., /music/...

---

Continue with Spotify Downloader, YouTube Downloader or TikTok Downloader.