Filename Templates

Filename Templates

Each downloader has its own naming scheme. It is set in the respective settings dialog under the "Filename" section.

---

Available schemes

Spotify

Scheme	Example result
{artist} - {title}	Daft Punk - Get Lucky.mp3
{title} - {artist}	Get Lucky - Daft Punk.mp3
{title}	Get Lucky.mp3
{artist} - {title} ({year})	Daft Punk - Get Lucky (2013).mp3
{title} [{album}]	Get Lucky [Random Access Memories].mp3

Default: {artist} - {title}

YouTube and TikTok

Scheme	Example result
{title}	My Video Title.mp4
{artist} - {title}	Channel Name - My Video Title.mp4
{title} - {artist}	My Video Title - Channel Name.mp4

Default in both cases: {title}

---

Placeholders

Placeholder	Spotify	YouTube and TikTok
{artist}	All artists of the track, comma separated	Part before the first " - " in the title
{title}	Track title	Part after the first " - ", otherwise the whole title
{album}	Album name	empty
{year}	Release year, four digits	empty

YouTube and TikTok have no real metadata fields for artist and album. The app therefore splits the video title at the first " - ". From Rick Astley - Never Gonna Give You Up you get {artist} as Rick Astley and {title} as Never Gonna Give You Up. Without that separator, {artist} stays empty and the entire title goes into {title}.

For TikTok the uploader name is prefixed when known, so {artist} there usually holds the channel name.

---

Cleaning up empty placeholders

Empty fields would otherwise leave ugly leftovers. The app cleans this up automatically:

Case	Result
Empty () pair	Removed
Empty [] pair	Removed
Duplicate spaces	Collapsed into one
Leading and trailing -, _ and spaces	Trimmed

Example: for a YouTube video with no recognizable artist and no year, the scheme {artist} - {title} ({year}) does not produce - Title () but simply Title.

If a scheme contains an unknown placeholder, a fallback kicks in and only the title is used. If nothing remains after that, the file is named track.

---

Character handling on Windows

Windows forbids \ / : * ? " < > | in filenames. The app handles these differently:

Character	Handling	Reason
\ / * ? " < >	Removed without replacement	No sensible substitute
Pipe	Replaced with ｜ (U+FF5C)	Visually identical but allowed
Colon	Replaced with ꞉ (U+A789)	Visually identical but allowed

This keeps titles such as Song: The Sequel readable instead of silently dropping characters. This handling was introduced in version 1.5.3.

Afterwards multiple spaces are collapsed and the name is trimmed.

---

Collisions

The app does not append a running number. Two different titles that produce the same name after cleanup would target the same file.

• In the Spotify downloader "Skip Existing Files" then applies, if enabled, and the second track is skipped.
• In YouTube and TikTok an already existing target file is always skipped.

To avoid name collisions, pick a scheme with more distinguishing information, for example {artist} - {title} ({year}) instead of {title}.

---

Where this is stored

Configuration key	Downloader
sp_filename_template	Spotify
yt_filename_template	YouTube
tt_filename_template	TikTok

See Settings.