Settings

Settings

All settings live in a single JSON file:

%USERPROFILE%\.spotify_downloader\config.json

The same folder also holds:

File	Contents
config.json	All settings
language	de or en, written by the installer
.spotify_token_cache	OAuth token from Spotify

On load, saved values are layered on top of the defaults. New keys from a new version therefore get their default value automatically without invalidating the existing configuration. If the file is corrupted, the app falls back to the defaults instead of crashing.

---

General

Key	Default	Meaning
output_dir	%USERPROFILE%\Music\Spotify Downloads	Output folder, shared by all three downloaders
launcher_pos	empty	Remembered position of the launcher window

---

Spotify

Key	Default	Meaning
spotify_client_id	empty	Client ID from the Spotify dashboard
spotify_client_secret	empty	Client Secret from the Spotify dashboard
default_format	MP3 (256 kbps)	Last selected audio format
concurrent_downloads	2	Number of parallel downloads
sp_skip_existing	true	Skip files that already exist
sp_embed_cover	true	Embed album artwork into the audio file
sp_normalize	false	loudnorm filter for consistent volume
sp_open_folder	true	Open the output folder when everything is finished
sp_filename_template	{artist} - {title}	Naming scheme
sp_win_geo	empty	Window size and position

---

YouTube

Key	Default	Meaning
yt_media_type	Audio	Last selected mode, Audio or Video
yt_format_audio	MP3 (256 kbps)	Last selected audio format
yt_format_video	MP4 (1080p)	Last selected video format
yt_concurrent	2	Number of parallel downloads
yt_embed_thumbnail	true	Embed the video thumbnail as cover art
yt_write_subtitles	false	Download and embed subtitles
yt_subtitle_langs	en	Languages, comma separated
yt_sponsorblock	false	Remove sponsor and self-promotion segments
yt_rate_limit	empty	1M, 5M, 10M, 50M or empty for no limit
yt_open_folder	true	Open the output folder when everything is finished
yt_filename_template	{title}	Naming scheme
yt_win_geo	empty	Window size and position

The key yt_format is a leftover from older versions and is no longer evaluated.

---

TikTok

Key	Default	Meaning
tt_media_type	Video	Last selected mode, Audio or Video
tt_format_audio	MP3 (256 kbps)	Last selected audio format
tt_format_video	MP4 (1080p)	Last selected video format
tt_concurrent	2	Number of parallel downloads
tt_embed_thumbnail	true	Embed the video cover as an image
tt_rate_limit	empty	1M, 5M, 10M, 50M or empty for no limit
tt_open_folder	true	Open the output folder when everything is finished
tt_filename_template	{title}	Naming scheme
tt_win_geo	820x720	Window size and position

---

Language

The language is not stored in config.json but in a separate file:

%USERPROFILE%\.spotify_downloader\language

Its content is either de or en. The installer writes it based on the selected setup language. To change the language afterwards, replace the content of this file and restart the app:

echo en > "%USERPROFILE%\.spotify_downloader\language"

If the file contains an unknown code or is missing, the app uses English. If an individual translation is missing, the English text is used automatically.

---

Example file

{
  "spotify_client_id": "abc123...",
  "spotify_client_secret": "def456...",
  "output_dir": "C:\\Users\\Name\\Music\\Downloads",
  "default_format": "MP3 (320 kbps)",
  "concurrent_downloads": 3,
  "sp_skip_existing": true,
  "sp_embed_cover": true,
  "sp_normalize": false,
  "sp_open_folder": true,
  "sp_filename_template": "{artist} - {title}",
  "yt_media_type": "Video",
  "yt_format_audio": "MP3 (256 kbps)",
  "yt_format_video": "MP4 (1080p)",
  "yt_concurrent": 2,
  "yt_embed_thumbnail": true,
  "yt_write_subtitles": true,
  "yt_subtitle_langs": "de, en",
  "yt_sponsorblock": true,
  "yt_rate_limit": "10M",
  "yt_open_folder": true,
  "yt_filename_template": "{title}",
  "tt_media_type": "Video",
  "tt_format_video": "MP4 (1080p)",
  "tt_format_audio": "MP3 (256 kbps)",
  "tt_concurrent": 2,
  "tt_embed_thumbnail": true,
  "tt_rate_limit": "",
  "tt_open_folder": true,
  "tt_filename_template": "{title}"
}

---

Resetting

Every downloader's settings have a Clear Config Data button in the "Uninstall & Cleanup" section. It removes the entire %USERPROFILE%\.spotify_downloader folder, including credentials and the token cache.

Alternatively delete the folder by hand. On the next start the app recreates it with the defaults.