与youtube-dl等区别

• 与 youtube-dl 和 youtube-dlc 不同，yt-dlp 仅支持 Python 3.7 及以上。相比之下，youtube-dl 支持 Python 2.6+ 和 3.2+。

• 尽管 ffmpeg是处理媒体的推荐选项，但在 yt-dlp 中不支持将 avconv 作为ffmpeg的替代选项。

• yt-dlp 在配置文件存储方面与 youtube-dl 稍有不同。

• yt-dlp 中的 F输出格式已更改。

• 选项 -auto-number (-A)、-title (-t) 和-literal (-l) 已被弃用，不再按预期工作。

• 默认情况下，yt-dlp 启用 –no-abort-on-error。

• yt-dlp 的默认输出模板与 youtube-dl 不同。yt-dlp 默认使用%(title)s [%(id)s].%(ext)s，而 youtube-dl 使用%(title)s-%(id)s.%(ext)s。

• yt-dlp 的默认格式排序优先考虑更高分辨率和更好的编解码器，而不是更高的比特率，这与 youtube-dl 不同。

• yt-dlp 中默认的格式选择器是bv*+ba/b，意味着首选包含视频和音频的格式，而不是仅视频格式。

• 与 youtube-dlc 不同，yt-dlp 默认情况下不允许将多个音频/视频流合并为一个文件（以避免与 f bv*+ba 冲突）。

• 使用 yt-dlp 时，对于播放列表，还会写入元数据文件，例如缩略图、描述或 infojson。

• yt-dlp 会为 YouTube 播放列表列出不可用的视频。

• yt-dlp 提取的 YouTube 上传日期为协调世界时 (UTC) 时间。

• 默认情况下，yt-dlp 在 infojson 中排除了一些内部元数据（例如文件名）。

• yt-dlp 中文件名中无效字符的清理方法不同，通常被认为更智能，与 youtube-dl 不同。

• yt-dlp 尝试将外部下载器的输出解析为标准进度输出，目前已在 aria2c 中实现。若要保留下载器的原始输出，请使用-compat-options no-external-downloader-progress。

在Windows上安装yt-dlp

• 打开

• 直接保存yt-dlp.exe文件，并添加保存文件的路径到系统环境变量中

• 例如，保存到c:\bin\yt-dlp.exe，将c:\bin\添加到系统环境变量中

更新 yt-dlp

在Linux上安装yt-dlp

方法一: 使用 Curl

方法二: 使用 wget

方法三: 使用 aria2c

Alpine Linux

Arch Linux, EndeavourOS, Manjaro Linux

Debian, Ubuntu, Linux Mint, Pop!_OS

Fedora

openSUSE

更新 yt-dlp

注意❗

需要注意的是官方存储库中提供的版本有时可能会稍微过时。为了获取最新的功能和更新，通常建议使用官方推荐的方法，包括curl或wget，如前文所示。这些方法可确保您获得最新版本的yt-dlp。

在 Android 上安装 yt-dlp

下载Termux

安装必要的依赖项

下载视频教程

查看视频信息

• 在下载视频之前获取视频的文件大小，请使用-F标志

下载特定质量和格式视频

• 默认情况下，yt-dlp 下载最佳质量视频。

• YouTube 提供以下视频下载质量选项：

• best: 这将选择可用的最高质量格式，包括视频和音频。

• worst: 它为视频和音频选择最低质量的格式。

• bestvideo: 此选项选择最佳质量的纯视频格式（例如，DASH 视频）。

• worstvideo: 与 bestvideo 类似，但选择最低质量的纯视频格式。

• bestaudio: 这将选择最佳质量的纯音频格式。

• worstaudio: 与 bestaudio 类似，但选择最低质量的纯音频格式。

下载最低质量纯视频

组合下载不同格式

• 如果您不想合并音频和视频，请将加号 (+) 运算符替换为逗号 (,)

• 此命令会分别下载最佳质量的视频和音频，从而生成两个文件。

• 在这种情况下，建议使用输出模板（-o 选项），因为 bestvideo 和 bestaudio 可能具有相同的文件名。

指定分辨率下载视频

组合格式下载特定质量视频

• 灵活地使用缩写的标志

• 使用bv代替bestvideo。

• 同样，您可以使用w表示worst，

• 使用wv表示worstvideo

• 下载最佳的纯视频格式和最佳的纯音频格式或最佳组合格式（如果纯视频不可用）

交互式下载视频

• 使用 f – 标志以交互方式选择每个视频的格式。

• 这将提示您提供可用格式的列表，以及它们的 ID、扩展名、分辨率、文件大小和音频/视频编解码器。

• 要下载特定格式，请键入文件的 ID，然后按 Enter。

• 下载默认选择，请按 Enter 键而不键入任何内容。

• 要退出交互式格式选择提示，请按 Ctrl+C

使用格式 ID 下载视频

• 如果想下载同一视频的多种格式，可以使用逗号作为分隔符。

• 例如，使用 f 22,17,18 将下载所有这三种格式（前提是它们可用）。

• 数字22、17和18对应于各个视频格式的ID。这些 ID 在 yt-dlp 的输出中称为“格式代码”。可以使用以下任一命令列出可用格式来发现这些 ID：

• 第一列中列出了可用格式的 ID。最佳质量格式通常在末尾找到，通常带有 247 这样的 ID。

• 因此，要下载最佳质量格式，可以使用以下命令：

• 如果打算下载多个视频，并且它们不共享相同的可用格式，可以使用斜杠指定优先顺序。

• 需要注意的是，左侧的格式优先。例如，使用f 22/17/18意味着它将尝试下载格式 22（如果可用），然后尝试下载格式 17（如果格式 22 不可用），依此类推。

• 如果没有指定的格式可用，它会通知您没有找到合适的下载格式。请记住，斜杠是左关联的，这意味着在选择过程中优先考虑左侧的格式。

按文件扩展名下载视频

• 下载指定格式（例如 MP4）的视频

• 需要注意的是，并非所有视频都可以您所需的格式提供。在这种情况下，yt-dlp 将自动下载最佳可用格式。

• 以下命令将下载最佳质量的 MP4 格式文件。如果给定视频的 MP4 格式不可用，它将下载最佳的替代格式

• 使用自定义文件名保存这些文件

设置视频下载的大小限制

• 从播放列表下载多个视频时，可能需要指定大小范围内的视频。例如，要确保不下载小于指定大小（例如 100MB）的视频

• 相反，如果希望避免下载大于给定大小的视频，您可以使用：

• 还可以选择组合格式选择运算符来下载特定大小的视频。例如，后续命令将下载最佳的纯视频格式，只要它不超过 100MB：

按日期下载视频

• 据上传日期过滤和下载视频或播放列表的功能，这在处理包含数百个视频的播放列表时非常有用

从播放列表下载特定视频

• 例如，要从播放列表下载 20 个视频，请执行以下命令：

• 同时下载视频并将其转换为其他格式。

• 在以下示例中，该命令将从播放列表中下载第一个视频并将其转换为 .mp3 格式：

• 仅下载播放列表中第二到第五位置的视频：

设置下载速度

• 要控制下载速度，您可以使用 r 选项。例如，以下命令将速度限制为每秒 50 KB：

• 请注意，速度以每秒字节数指定

将视频直接流式传输到媒体播放器

• 要将媒体直接流式传输到媒体播放器，您需要使用o -选项指示 yt-dlp 流式传输到标准输出。此外，您的媒体播放器应该能够从标准输入读取。

• 您可以通过将 yt-dlp 的输出通过管道传输到媒体播放器来实现此目的。例如，要流式传输到 VLC，您可以使用以下命令：

• 如果您安装了 ffmpeg，则在流式传输到标准输出时可以使用“o - --downloader ffmpeg -f "bv*+ba/b"选项以获得最佳可用质量。

基本命令

下载视频

下载播放列表

下载到特定位置

并行下载多个视频

• 可以创建一个包含要下载的所有视频 URL 的文本文件，然后将此文件作为参数传递给 yt-dlp：

• 通过使用此命令，yt-dlp 将自动下载 url.txt 文件中列出的所有视频。这种方法在处理大量视频时特别方便，因为它可以为您简化流程。

从视频下载纯音频

• 要将视频下载为音频，即从视频中提取音频，请使用 x 标志，如下所示。

• 还可以使用x --audio-format标志指定输出音频格式。

下载最佳品质

下载具体格式

下载最佳音频

常用命令

查看视频信息

限制下载速度

恢复下载

按日期过滤

按年龄限制过滤

按标题过滤

按格式代码下载

按文件扩展名下载

设置大小限制

从播放列表下载特定视频

下载字幕

显示视频所有字幕

下载srt字幕

将字幕内嵌到视频

• 也可以在下载视频时直接将自动生成的字幕文件内嵌到视频中，这里我选择将中/英文字幕直接内嵌到视频中：

转换到指定格式

偶尔可能遇到的常见错误。大多数这些问题可以通过将 yt-dlp 更新到最新版本来解决。但是，即使使用更新版本的 yt-dlp，也可能存在一些错误，例如下面列出的错误:

错误：“Sign in to confirm you’re not a bot. This helps protect our community”

• 使用edge或chrome等chromium内核的浏览器，安装扩展： Edge应用商店 | Chrome 应用商店

• 打开youtube网页，并登录

• 导出cookies.txt

修复”Unable to download video data: HTTP Error 403: Forbidden”错误

• 下载视频时，有时会出现如下错误。

错误： Unable to Open for Writing: [Errno 36] File Name Too Long