跳至內容
出自 Arch Linux 中文维基

yt-dlp 是一款可讓您輕鬆從一千多個網站下載視頻和音頻的命令行程序。查看受支持的網站列表

注意:yt-dlp 是 youtube-dl 的一個分支,創建於原項目停滯之後。上游的 youtube-dl 仍可通過 youtube-dlAUR安裝;本頁的命令通常仍可正常使用,但請參閱默認行為差異列表以了解具體區別。

安裝

安裝yt-dlp,或者開發版本 yt-dlp-gitAUR 。同時建議安裝 FFmpeg(用來封裝部分網站的文件),請參閱可選依賴項。

yt-dlp 還有各種圖形前端,如 parabolic-gtkAURtartubeAURyt-dlg-gitAUR

您還可以安裝 yt-dlp-drop-inAUR,它提供了一個占位的 /usr/bin/youtube-dl 可執行文件(只是重定向到 yt-dlp),以兼容那些仍在尋找 youtube-dl 可執行文件的過時程序。

配置

系統全局配置文件是 /etc/yt-dlp.conf,用戶的配置文件為~/.config/yt-dlp/config。配置示例:

--ignore-errors
# --no-playlist

# 保存至 ~/Videos
-o ~/Videos/%(title)s.%(ext)s

# 首选1080p或更低的分辨率
-f bestvideo[height<=?1080]+bestaudio/best

更多信息請參見[1]

自定義配置文件也可以指定:

$ yt-dlp URL --config-locations PATH

用法

請參見 yt-dlp(1) 手冊。

$ yt-dlp [OPTIONS] URL
提示:在某些情況下(如 YouTube)URL 可以用視頻ID代替。

格式選擇

當多種格式的視頻可用時,yt-dlp將默認下載最好的格式。

獲取可用格式的列表:

$ yt-dlp -F URL

選擇一個特定的要下載:

$ yt-dlp -f format URL

提取音頻

使用-x下載音頻(需要 FFmpeg):

$ yt-dlp -x -f bestaudio URL

根據可用的源流,這通常可以修正純音頻容器。若無可用的純音頻流,請從上述示例中移除 -f bestaudio 參數。此操作會先下載視頻文件,並在後續處理中提取其音頻。默認情況下會刪除已下載的視頻文件,添加 -k 參數可保留視頻文件。

同時包括專輯封面:(需要atomicparsley):

$ yt-dlp -x -f bestaudio[ext=m4a] --add-metadata --embed-thumbnail URL

字幕

查看哪些語言可用:

$ yt-dlp --list-subs URL

下載帶有選定字幕(用逗號分隔)的視頻:

$ yt-dlp --write-sub --sub-lang LANG URL

對於自動生成的字幕:

$ yt-dlp --write-auto-sub --sub-lang LANG URL

添加--skip-download僅獲取字幕。

Cookie

要導入 cookie,添加 --cookies-from-browser <browser>

例如,從 chromium 導入:

$ yt-dlp --cookies-from-browser chromium URL

方法與技巧

更快的下載

一些網站限制了傳輸速度。您通常可以通過選擇非DASH流或使用支持多連接下載的外部下載器 aria2 來繞過這種限制。例如:

$ yt-dlp --downloader aria2c --downloader-args '-c -j 3 -x 3 -s 3 -k 1M' URL

播放列表

將 yt-dlp 用於播放列表通常歸結為以下選項:

$ yt-dlp --ignore-errors --continue --no-overwrites --download-archive progress.txt usual options URL

這組選項允許下載在中斷後仍能有效繼續。如果您正在進行歸檔操作,請添加您可能需要的常規選項,例如 --write-xxx--embed-xxx

修剪(部分下載)

可以通過將 yt-dlp -g -f format URL 的輸出作為 ffmpeg 的輸入,並結合 -ss(用於輸入)、-t-c copy 選項來下載視頻片段。

來自剪貼板的URL

可以通過設置一個 Shell 別名桌面啟動器英語desktop launcher或鍵盤快捷鍵,從 X Window 選區中輸出選中(或複製)的 URL 以下載視頻或音頻。具體方法可參閱剪貼板工具

另請參閱