哔哩哔哩的 yt-dlp 指令產生器

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --no-playlist --impersonate chrome --cookies-from-browser chrome https://www.bilibili.com/video/BV1xx411c7mD

基本

你要什麼

影片 僅音訊

僅音訊會擷取聲音軌並捨棄影像串流。

影片與畫質

最高畫質 -f 可用的最佳畫質 4K（2160p） 2K（1440p） 1080p 720p 480p 360p

限制高度上限。yt-dlp 仍會挑該上限以下最好的一路串流。

Container --merge-output-format 需要 ffmpeg 保持原樣 MP4（相容性最好） MKV（什麼都裝得下） WebM MOV

把分離的影像與音訊串流合併進去的檔案類型。

進階選項（3）

自訂 format selector -f

會取代畫質下拉選單。給已經熟悉 format 語法的人用。

Remux 成 --remux-video 需要 ffmpeg 不使用 MP4（相容性最好） MKV（什麼都裝得下） WebM MOV

不重新編碼，只重新封裝。快而且無損。

重新編碼成 --recode-video 需要 ffmpeg 不使用 MP4（相容性最好） MKV（什麼都裝得下） WebM

重新編碼影片。慢而且有損 —— 只在 remux 行不通時才用。

音訊

音訊格式 --audio-format 需要 ffmpeg MP3 M4A（AAC） Opus FLAC（無損） WAV（無損） Vorbis 可用的最佳音訊（不轉換）

音訊要轉換成的檔案類型。

音訊品質 --audio-quality 需要 ffmpeg 最佳（VBR） 320 kbps 256 kbps 192 kbps 128 kbps

VBR 的檔案大小與品質之比最好；固定 bitrate 比較好預估大小。

字幕

字幕 不使用 內嵌進影片 另存成 .srt 檔 內嵌並另存檔案

內嵌會把字幕放進影片裡；另存則在旁邊寫一個獨立的 .srt 檔。

字幕語言 --sub-langs

用逗號分隔。想要所有可用語言就寫 all。

自動產生的字幕 --write-auto-subs 在沒有人工字幕時，把機器產生的字幕也算進來。

播放清單與頻道

播放清單處理 交給 yt-dlp 判斷 只要這支影片 整份播放清單

當網址同時屬於一支影片和一份播放清單時該怎麼做。

要哪幾項 -I

範圍與清單都可以，例如 1-10,15，或用 -5::2 表示從尾端起每隔一項取一項。

進階選項（1）

紀錄檔 --download-archive

記下已經下載過的項目，於是重新執行會跳過它們。這就是讓一個頻道保持同步的做法。

片段與章節

進階選項（2）

只下載其中一段 --download-sections 需要 ffmpeg

像 *00:01:30-00:03:00 這樣的時間範圍，或章節名稱。開頭的星號表示這是時間點。

依章節切分 --split-chapters 需要 ffmpeg 每個章節寫成一個檔案，而不是一整個長檔。

中繼資料與封面

內嵌縮圖 --embed-thumbnail 需要 ffmpeg 把影片縮圖當作封面。

內嵌中繼資料 --embed-metadata 需要 ffmpeg 把標題、上傳者與日期寫進檔案本身。

內嵌章節 --embed-chapters 需要 ffmpeg 加入章節標記，播放器可以在它們之間跳轉。

進階選項（3）

另存縮圖檔 --write-thumbnail 把封面圖片寫在影片旁邊。

另存簡介 --write-description 把簡介寫進一個 .description 檔。

另存中繼資料 JSON --write-info-json 把 yt-dlp 對這支影片知道的一切寫進 .info.json 檔。

SponsorBlock

移除片段 --sponsorblock-remove 需要 ffmpeg 不使用 只有贊助片段 贊助、片頭與自我宣傳 所有被標記的片段

依 SponsorBlock 資料，把社群標記的片段直接從檔案裡剪掉。

進階選項（1）

把片段標成章節 --sponsorblock-mark 不使用 贊助、片頭與自我宣傳 所有被標記的片段

片段保留，但會被標出來，讓你自己跳過。

檔案與資料夾

檔名範本 -o

標題 標題 + ID 帶編號的播放清單 上傳者 / 日期 - 標題

欄位名稱寫在 %(...)s 裡。斜線會建立資料夾。

安全（純 ASCII）檔名 --restrict-filenames 去掉重音符號、空白，以及某些挑剔的檔案系統可能拒絕的字元。

覆寫已存在的檔案 --force-overwrites 取代已經存在的檔案。

續傳未完成的下載 -c 從中斷的地方接著下。

進階選項（4）

下載資料夾 -P

檔案要寫到哪裡。搭配上面的範本可以產生子資料夾。

相容 Windows 的檔名 --windows-filenames 去掉 Windows 不接受的字元，即使你在別的系統上執行。

檔名裁到 --trim-filenames

檔名最大長度，以字元計。

永不覆寫 -w 跳過任何已經下載過的東西。

篩選

進階選項（5）

上傳時間晚於 --dateafter

YYYYMMDD，或像 now-1month 這樣的相對日期。

上傳時間早於 --datebefore

YYYYMMDD，或相對日期。

最小檔案大小 --min-filesize

跳過更小的檔案。可以寫 5M、500K 之類。

最大檔案大小 --max-filesize

跳過更大的檔案。

下載幾個後停止 --max-downloads

停下來之前要下載的檔案數量。

網路

限速 -r

例如 2M 或 500K。當你需要把剩下的頻寬留給別的事情時很有用。

進階選項（5）

同時下載的 fragment 數 -N

能加快分片串流的下載。從 4 開始比較合適。

重試次數 -R

失敗的片段要重試幾次。也可以寫 infinite。

Proxy --proxy

HTTP、HTTPS 或 SOCKS proxy 的網址。

繞過地區限制 --geo-bypass 偽造請求來源。在部分網站有效，並非全部。

偽裝成瀏覽器 --impersonate 不使用 Chrome Edge Safari Firefox

讓請求看起來來自真正的瀏覽器。突然出現 403 時，這是最常見的解法。

登入與 cookies

從瀏覽器讀取 cookies --cookies-from-browser 不使用 Chrome Firefox Edge Brave Safari Chromium Opera Vivaldi

直接讀取你的登入工作階段。私人、年齡限制或會員專屬內容都需要它。

進階選項（1）

Cookies 檔案 --cookies

從瀏覽器匯出的 Netscape 格式 cookies.txt。

直播

進階選項（2）

從直播開頭錄 --live-from-start 從直播開始處錄製，而不是從目前這一刻。

等待直播開始 --wait-for-video

反覆檢查直到預定的直播開始。MIN-MAX 是兩次檢查之間的秒數。

疑難排解

進階選項（3）

User agent --user-agent 已淘汰

已淘汰，應改用 --add-headers。之所以保留，是因為很多舊教學還在用它。

Referer --referer 已淘汰

已淘汰，應改用 --add-headers。

Extractor 參數 --extractor-args

依網站區分的專用選項，例如 youtube:player_client=web。

輸出與除錯

只列出格式 -F 印出可用格式後直接結束，不下載。

進階選項（2）

出錯也繼續 -i 跳過失敗的項目而不是停下來。處理大型播放清單時不可或缺。

模擬執行 -s 除了寫檔以外的一切都做。