跳转到内容

yt-dlp

来自 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 以下载视频或音频。具体方法可参阅剪贴板工具

另请参阅[编辑 | 编辑源代码]