# yt-dlp 配置檔 - 最高音質播放清單下載
# 使用方法: yt-dlp --config-location yt-dlp.conf "播放清單URL"

# ========== 音質設定 ==========
# 選擇最佳音訊串流（使用靈活的格式選擇）
# 優先選擇純音訊，若無則從影片提取音訊
-f bestaudio/best

# 提取音訊
-x

# 輸出為 MP3 格式（相容性最好，320kbps 高品質）
--audio-format mp3

# 音訊品質設定（0 = 最高品質）
--audio-quality 0

# ========== 檔案命名格式 ==========
# 格式: 播放清單名稱/0001 - 歌曲標題.副檔名
# %(playlist_index)04d 表示 4 位數序號（0001, 0002...）
-o "%(playlist_title)s/%(playlist_index)04d - %(title)s.%(ext)s"

# ========== 元數據設定 ==========
# 嵌入縮圖作為封面
--embed-thumbnail

# 轉換縮圖為 JPG（相容性更好）
--convert-thumbnails jpg

# 添加元數據（歌曲資訊、藝術家等）
--add-metadata

# 寫入縮圖檔案（除了嵌入外也保存縮圖）
--write-thumbnail

# ========== 下載選項 ==========
# 忽略錯誤繼續下載
--ignore-errors

# 不覆蓋已存在的檔案
--no-overwrites

# 繼續未完成的下載
--continue

# 下載整個播放清單
--yes-playlist

# ========== 顯示設定 ==========
# 顯示詳細進度
--progress

# 不顯示警告訊息
--no-warnings

# 顯示每個影片的標題
--print "正在下載: %(playlist_index)04d - %(title)s"

# ========== 速度與連線設定 ==========
# 重試次數
--retries 10

# 片段重試次數
--fragment-retries 10

# 限速（如不需要限速可註解掉）
# --limit-rate 5M

# ========== 其他進階設定 ==========
# 下載字幕（如果需要）
# --write-subs
# --sub-langs zh-TW,zh-Hans,en

# 保留原始影片（如果需要影片檔）
# --keep-video

# 後處理器：標準化音訊
# --postprocessor-args "ffmpeg:-ar 48000"

# 嵌入章節資訊（如果有）
--embed-chapters

# 使用 cookies（如果需要登入才能存取的播放清單）
# --cookies-from-browser chrome