spotizerr-dev/docs/user/configuration.md

Configuration

See also: Environment variables

Open Configuration in the web UI. Tabs:

• General (admin)
  • App version, basic info
• Downloads (admin)
  • Concurrent downloads, retry behavior
  • Quality/format defaults and conversion
  • Real-time mode (Spotify only): aligns download time with track length
• Formatting (admin)
  • File/folder naming patterns (examples)
    • %artist%/%album%/%tracknum%. %title%
    • %ar_album%/%album% (%year%)/%title%
• Accounts (admin)
  • Spotify: use spotizerr-auth to add credentials
  • Deezer ARL (optional):
    • Chrome/Edge: devtools → Application → Cookies → https://www.deezer.com → copy arl
    • Firefox: devtools → Storage → Cookies → https://www.deezer.com → copy arl
    • Paste ARL in Accounts
  • Select main account when multiple exist
• Watch (admin)
  • Enable/disable watch system
  • Set check intervals
  • Manually trigger checks (artists/playlists)
• Server (admin)
  • System info and advanced settings
• Profile (all users when auth is enabled)
  • Change password, view role and email

Quality formats (reference):

• Spotify: OGG 96k/160k/320k (320k requires Premium)
• Deezer: MP3 128k/320k (320k may require Premium), FLAC (Premium)
• Conversion: MP3/FLAC/AAC/OGG/OPUS/WAV/ALAC with custom bitrate

Fallback system:

• Configure primary and fallback services
• Automatically switches if primary fails (useful for geo/account limits)

Notes:

• Explicit content filter applies in pages (e.g., hides explicit tracks on album/playlist views)
• Watch system must be enabled before adding items