Variables Guide

This guide provides a detailed explanation of the variables available in OnTheSpot for customizing file names and organization of downloaded content.

---

Universal Variables

These variables can be used across all file types to define naming and organizational conventions.

Variable	Description
{service}	The name of the music service used to download the file (e.g., Spotify, Tidal).
{service_id}	The native ID of the track, album, or playlist on the selected music service.
{name}	The name of the track, album, or playlist.
{year}	The release year of the track, album, or playlist.
{explicit}	Displays the explicit label if applicable (default: 🅴).

---

Audio-Specific Variables

These variables apply specifically to audio tracks and albums.

Variable	Description
{artist}	The name of the artist(s).
{album_artist}	The name of the album artist(s).
{album_type}	The type of album (e.g., single, album, compilation).
{disc_number}	The disc number if the album has multiple discs.
{discccount}	The total number of discs in the album.
{genre}	The genre of the track or album.
{label}	The name of the record label.
{track_number}	The track number within the album.
{trackcount}	The total number of tracks in the album.
{isrc}	The International Standard Recording Code (ISRC) for the track.
{playlist_name}	The name of the playlist (if part of a playlist).
{playlist_owner}	The owner or creator of the playlist.
{playlist_number}	The position of the track within the playlist.

---

Video-Specific Variables

These variables are applicable to videos, including movies and TV episodes.

Variable	Description
{show_name}	The name of the show or series.
{season_number}	The season number of the show.
{episode_number}	The episode number within the season.
{movie_title}	The title of the movie.
{release_year}	The release year of the movie or episode.

---

Examples

Format	Result
{artist} - {name}	Artist Name - Song Title.mp3
{album_artist}/{album}/{track_number} - {name}	Album Artist/Album Name/01 - Song Title.mp3
{service}/{playlist_name}/{playlist_number} - {name}	Spotify/Chill Playlist/01 - Relaxing Song.mp3
{show_name}/Season {season_number}/{episode_number} - {name}	My Favorite Show/Season 2/03 - Episode Title.mp4

---

Usage Tips

1. Use Consistent Variables: Ensure you use variables appropriate for the media type (e.g., audio or video).
2. Check File Systems: Avoid using variables that include characters not supported by your file system (e.g., ?, *, \).
3. Preview Formats: Test your variable setup with a single download to ensure the format meets your expectations.

---

For more information, refer to the main configuration guide or reach out on the community Discord.