跳至內容
yt-dlp

Vimeo 的 yt-dlp 指令產生器

為 Vimeo 影片產生 yt-dlp 指令,包括私人影片與被限制網域的嵌入影片。

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

你的指令

yt-dlp --merge-output-format mp4 --no-playlist --embed-metadata https://vimeo.com/123456789
基本

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

影片與畫質

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

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

進階選項(3)

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

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

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

音訊

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

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

字幕

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

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

播放清單與頻道

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

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

進階選項(1)

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

片段與章節
進階選項(2)

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

中繼資料與封面
進階選項(3)
SponsorBlock

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

進階選項(1)

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

檔案與資料夾

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

進階選項(4)

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

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

篩選
進階選項(5)

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

YYYYMMDD,或相對日期。

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

跳過更大的檔案。

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

網路

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

進階選項(5)

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

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

HTTP、HTTPS 或 SOCKS proxy 的網址。

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

登入與 cookies

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

進階選項(1)

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

直播
進階選項(2)

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

疑難排解
進階選項(3)

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

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

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

輸出與除錯
進階選項(2)
重設

私人影片與受限影片

Vimeo 允許上傳者把播放限制在特定網域。當一支影片在某個網站上能播、但用純 yt-dlp 指令不行時,缺的通常就是指向那個頁面的 referer。

私人影片需要有權限帳號的 cookies。有密碼的影片用的是另一個選項,我們刻意沒把它放進這個表單 —— 它是機密資訊,而分享連結會把它一起帶走。

Vimeo 的畫質是簡單的部分:階梯很誠實,1080p 和 4K 有就是有,高度上限按文件行事。變數在存取。僅限嵌入播放的影片在所有者網站的播放器裡播放;yt-dlp 需要一個與那個頁面匹配的 referer 標頭,本表單會提供——出錯的樣子是 referer 指向嵌入所在的網域之外的域,Vimeo 把它讀作未授權。

Vimeo 把大量商業內容擋在自己的付費牆後面——租借影片、課程平台、架在 Vimeo 白標播放器上的作品集網站。那些只有在買了它們的憑證下才能解析,如果還能解析的話:課程平台的播放器不是公開的 Vimeo 播放器,yt-dlp 無路可過。如果影片在一個你付費的網站裡播放,下載選項是那個網站自己的;為它而設的裸 Vimeo 網址並不存在。

就檔案本身而言,章節和字幕和其他地方一樣一路帶上——--write-subs 保存上傳者附加的內容,而 Vimeo 創作者對字幕異常勤勉,值得一試。4K 影片的文字軌很大;只要畫面的話,控制體積的就是高度上限本身,音軌會在合併時自動跟上。

一條值得點名的死路:私人 Showcase 連結和「連結本身就是秘密」的非公開影片——它們需要 --video-password 選項,而本表單有意不放它,因為一條可分享的網址帶著密碼是一筆壞交易。其餘的失敗都歸結到存取:私人用 cookies,嵌入用 referer,而且先更新 yt-dlp——Vimeo 的 extractor 被重做過不止一次。

常見問題

yt-dlp 能下載私人的 Vimeo 影片嗎?
只有在你的工作階段看得到它們時可以。用 --cookies-from-browser,並注意有些嵌入還會檢查來源頁面。
有密碼的影片怎麼辦?
yt-dlp 有 --video-password 可用於這種情況。它不在這個表單裡,因為它是機密資訊,而分享連結會把它一起帶走。
怎麼在 Vimeo 上取得最高畫質?
把畫質保持在最佳,或用 -F 查看可用的畫質階梯。有些版本只提供給已登入的工作階段。