From a06e3fa996e37f001169125ee1dc84bbb7ec50e8 Mon Sep 17 00:00:00 2001
From: Joren <jorensc@riseup.net>
Date: Fri, 24 Apr 2026 18:36:01 +0200
Subject: [PATCH] clarify provider quality ladders in config example

---
 config.toml.example | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/config.toml.example b/config.toml.example
index be395c6..b4309d4 100644
--- a/config.toml.example
+++ b/config.toml.example
@@ -18,7 +18,8 @@ requests_per_minute = 60
 verify_ssl = true
 
 [qobuz]
-# 1: 320kbps MP3, 2: 16/44.1, 3: 24/<=96, 4: 24/>96
+# Quality ladder (global scale is 0-4, Qobuz supports 1-4):
+# 1 = MP3 320, 2 = FLAC 16/44.1, 3 = FLAC 24-bit <=96kHz, 4 = FLAC 24-bit <=192kHz
 quality = 3
 # Download booklet PDFs when available
 download_booklets = true
@@ -35,7 +36,9 @@ app_id = ""
 secrets = []
 
 [tidal]
-# 0: AAC 256, 1: AAC 320, 2: FLAC 16/44.1, 3: FLAC hi-res when available
+# Quality ladder:
+# 0 = LOW (HEAACV1), 1 = HIGH (AACLC), 2 = LOSSLESS (FLAC), 3/4 = HI_RES_LOSSLESS when available
+# If a tier is unavailable, Tidal may fall back to the best available stream for that track.
 quality = 3
 # Prefer Dolby Atmos/immersive stream variants when available
 # Disabled by default because stereo FLAC is usually preferred
@@ -52,7 +55,8 @@ refresh_token = ""
 token_expiry = 0
 
 [deezer]
-# 0: MP3_128, 1: MP3_320, 2: FLAC
+# Quality ladder:
+# 0 = MP3_128, 1 = MP3_320, 2/3/4 = FLAC
 quality = 2
 # If target quality is unavailable, fallback down quality ladder
 lower_quality_if_not_available = true
@@ -65,7 +69,7 @@ password = ""
 refresh_token = ""
 
 [soundcloud]
-# Only 0 is currently supported
+# Quality is currently provider-defined (keep 0)
 quality = 0
 # Managed automatically when available
 client_id = ""
@@ -131,7 +135,7 @@ exclude = []
 [filepaths]
 # Create folders for single tracks using folder_format template
 add_singles_to_folder = false
-# Available keys: albumartist, title, year, bit_depth, sampling_rate, id, albumcomposer
+# Available keys: albumartist, title, year, bit_depth, sampling_rate, id, container, codec, quality, bitrate, albumcomposer
 folder_format = "{albumartist} - {title} ({year}) [{container}] [{bit_depth}B-{sampling_rate}kHz]"
 # Available keys: id, tracknumber, artist, albumartist, composer, title, albumcomposer, explicit
 track_format = "{tracknumber:02}. {artist} - {title}{explicit}"