# yt-dlp 配置檔 - 穩定版（最高音質）
# 使用方法: yt-dlp --config-location yt-dlp.conf "播放清單URL"

# ========== 音質設定 ==========
# 提取音訊（不指定具體格式，讓 yt-dlp 自動選擇）
--extract-audio

# 轉換為 MP3 格式（320kbps 高品質）
--audio-format mp3

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

# ========== 檔案命名格式 ==========
# 格式: 播放清單名稱/0001 - 歌曲標題.mp3
-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

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

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

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

# ========== Cookies 設定（如需登入）==========
# 根據你使用的瀏覽器選擇其中一個，移除前面的 # 來啟用
# --cookies-from-browser chrome
# --cookies-from-browser firefox
# --cookies-from-browser edge
# --cookies-from-browser safari

# ========== 其他設定 ==========
# 嵌入章節資訊（如果有）
--embed-chapters

# 限速（如不需要可移除）
# --limit-rate 5M