Advanced Usage

Advanced Usage

---

Custom File & Folder Naming Templates

Control exactly how your library is organized on disk using template variables.

Available Template Variables

Variable	Description
{title}	Track title
{artist}	Primary artist
{album}	Album name
{album_artist}	Album artist
{track}	Track number
{disc}	Disc number
{release_date}	Release date

Examples

# Organize as: Album Artist / Album / TrackNumber Title
dotify \
  --album-folder-template "{album_artist}/{album}" \
  --single-disc-file-template "{track:02d} {title}" \
  "spotify:album:..."
Multi-disc albums: include disc number in filename
dotify 

--album-folder-template "{album_artist}/{album}" 

--multi-disc-file-template "{disc}-{track:02d} {title}" 

"spotify:album:..."

---

Audio Quality Control

Pass a comma-separated priority list. Dotify tries each format in order, automatically falling back if a format is unavailable.

# 24-bit FLAC → FLAC → AAC 256kbps
dotify --audio-quality flac-flac-24,flac-flac,aac-high "spotify:album:..."
AAC 256kbps → 128kbps fallback
dotify --audio-quality aac-high,aac-medium "spotify:track:..."

See Audio-Quality-Reference for the complete list of format strings and tier breakdown.

---

Download Music Videos

# Download video stream if available
dotify --prefer-video "spotify:episode:..."
Cap maximum resolution
dotify --prefer-video --video-resolution 1080p "spotify:episode:..."

Requires mp4decrypt and MP4Box installed and in PATH. See Dependencies-Explained.

---

Download Synced Lyrics Only

If you already have your audio library and only want .lrc synced lyrics files:

dotify --synced-lyrics-only "spotify:playlist:..."
dotify --synced-lyrics-only "spotify:album:..."

---

Skip the Config File for One Run

dotify -n --audio-quality aac-medium "spotify:track:..."

The -n / --no-config-file flag ignores config.json entirely for that run.

---

Save Cover Art as a Separate File

dotify --save-cover-file "spotify:album:..."

Saves album artwork as a separate image file alongside audio files, in addition to embedding it in tags.

---

Use a Custom Config File

dotify --config-path ./my-hifi-config.json "spotify:album:..."

Useful for maintaining separate configs for different quality presets or output locations.