YouTube 的 yt-dlp 指令產生器

為 YouTube 的影片、播放清單或頻道產生完全正確的 yt-dlp 指令。預設從 1080p MP4 開始，含章節與中繼資料，並已移除贊助片段。

影片、播放清單或頻道網址

選填。留空的話指令會以 URL 結尾，由你自己填。

你的指令

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --embed-subs --sub-langs en --no-playlist --embed-thumbnail --embed-metadata --embed-chapters --sponsorblock-remove default 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'

基本

你要什麼

影片僅音訊

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

影片與畫質

最高畫質 -f

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

Container --merge-output-format 需要 ffmpeg

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

進階選項（3）

自訂 format selector -f

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

Remux 成 --remux-video 需要 ffmpeg

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

重新編碼成 --recode-video 需要 ffmpeg

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

音訊

音訊格式 --audio-format 需要 ffmpeg

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

音訊品質 --audio-quality 需要 ffmpeg

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

字幕

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

字幕語言 --sub-langs

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

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

播放清單與頻道

播放清單處理

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

要哪幾項 -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

欄位名稱寫在 %(...)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

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

登入與 cookies

從瀏覽器讀取 cookies --cookies-from-browser

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

進階選項（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 除了寫檔以外的一切都做。

重設

這裡最關鍵的選項

最高畫質 -f 限制高度上限。yt-dlp 仍會挑該上限以下最好的一路串流。
Container --merge-output-format 把分離的影像與音訊串流合併進去的檔案類型。
移除片段 --sponsorblock-remove 依 SponsorBlock 資料，把社群標記的片段直接從檔案裡剪掉。
字幕內嵌會把字幕放進影片裡；另存則在旁邊寫一個獨立的 .srt 檔。

YouTube 哪裡不一樣

在 720p 以上，YouTube 會把影像與音訊分成兩路獨立串流。因此任何要求 1080p 或 4K 的指令都必須兩路都取再合併，這也正是 720p 以上一定要有 ffmpeg、而 720p 以下不必的原因。本頁的預設已經處理好這件事。

關於 YouTube 另一件值得知道的事是機器人驗證。它出現時，偽裝成瀏覽器的成功率最高，再配上你自己的 cookies 就能涵蓋其餘情況 —— 年齡限制、會員專屬與私人影片都需要一個登入工作階段。

常見問題

› 怎麼用 1080p 或 4K 下載 YouTube？

720p 以上，YouTube 把影像與音訊分成兩路串流，所以指令必須兩路都要再合併 —— 這需要 ffmpeg。在上面選好解析度，產生器會替你寫好 selector 與 container。

› YouTube 要我確認我不是機器人。

加上 --impersonate chrome，或用 --cookies-from-browser chrome 重用你的登入工作階段。先關掉瀏覽器 —— Chrome 執行時會鎖住自己的 cookies 資料庫。

› 怎麼只取音訊並存成 MP3？

把輸出切成僅音訊並選 MP3。再加上封面與中繼資料，拿到的檔案就可以直接進音樂庫。需要 ffmpeg。

› 怎麼下載整份播放清單？

把播放清單處理設為整份播放清單。清單很長時，加上紀錄檔，這樣重新執行是接著做而不是從頭來；再打開出錯也繼續，這樣一支被封鎖的影片不會拖停其餘部分。

› 可以下載 YouTube 字幕嗎？

可以 —— 內嵌進影片，或另存成 .srt。也請打開自動產生的字幕，否則沒有人工字幕的影片什麼都不會產出。