与youtube-dl等区别 yt-dlp 的默认选项与 youtube-dl或youtube-dlc不同。以下是其中一些主要区别：
与 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-dlyt-dlp 默认使用%(title)s [%(id)s].%(ext)s，而 youtube-dl 使用%(title)s-%(id)s.%(ext)s。yt-dlp 的默认格式排序优先考虑更高分辨率和更好的编解码器，而不是更高的比特率，这与 youtube-d l 不同。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 要使 yt-dlp 保持最新，只需运行以下命令：
在Linux上安装yt-dlp 方法一: 使用 Curl 1 sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp sudo chmod a+rx /usr/local/bin/yt-dlp
方法二: 使用 wget 1 sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp sudo chmod a+rx /usr/local/bin/yt-dlp
方法三: 使用 aria2c 1 sudo aria2c https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp --dir /usr/local/bin -o yt-dlp sudo chmod a+rx /usr/local/bin/yt-dlp
Alpine Linux Arch Linux, EndeavourOS, Manjaro Linux Debian, Ubuntu, Linux Mint, Pop!_OS Fedora openSUSE 1 sudo zypper install yt-dlp
更新 yt-dlp 要使 yt-dlp 保持最新，只需运行以下命令：
注意❗
需要注意 的是官方存储库中提供的版本有时可能会稍微过时。为了获取最新的功能和更新，通常建议使用官方推荐的方法，包括curl或wget，如前文所示。这些方法可确保您获得最新版本的yt-dlp。
在 Android 上安装 yt-dlp 下载Termux 我们可以通过 Termux 在 Android 设备上安装 yt-dlp。
首先，在您的 Android 手机上安装 Termux。
然后，打开 Termux 应用程序并运行以下命令，授予 Termux 访问手机存储空间的权限，从而允许下载文件。
更新 Termux 中的所有软件包以确保您拥有最新版本。
1 pkg update && pkg upgrade
安装必要的依赖项 安装必要的依赖项，包括 Python、libexpat 和 OpenSSL。
1 pkg install libexpat openssl python
安装 yt-dlp 并确保其是最新的。 Pip 是 Python 的包管理器，将为您处理安装。
如果您打算进行相关的视频操作，建议安装 FFmpeg。此步骤是可选的，但对于视频相关任务很有用。
要使 yt-dlp 保持最新，请定期运行以下命令：
下载视频教程 查看视频信息
下载特定质量和格式视频
默认情况下，yt-dlp 下载最佳质量视频。
YouTube 提供以下视频下载质量选项：
best: 这将选择可用的最高质量格式，包括视频和音频。
worst: 它为视频和音频选择最低质量的格式。
bestvideo: 此选项选择最佳质量的纯视频格式（例如，DASH 视频）。
worstvideo: 与 bestvideo 类似，但选择最低质量的纯视频格式。
bestaudio: 这将选择最佳质量的纯音频格式。
worstaudio: 与 bestaudio 类似，但选择最低质量的纯音频格式。
下载最低质量纯视频 1 yt-dlp -f worstvideo <video_url>
组合下载不同格式 此命令下载最佳质量的纯视频和纯音频格式，并使用 ffmpeg合并它们。确保您的系统上安装了ffmpeg。
1 yt-dlp -f bestvideo+bestaudio <video_url>
如果您不想合并音频和视频，请将加号 (+) 运算符替换为逗号 (,)
此命令会分别下载最佳质量的视频和音频，从而生成两个文件。
在这种情况下，建议使用输出模板（-o 选项），因为 bestvideo 和 bestaudio 可能具有相同的文件名。
1 yt-dlp -f 'bestvideo,bestaudio' https://www.youtube.com/watch?v=t5b20oLaIaw -o '%(title)s.f%(format_id)s.%(ext)s'
指定分辨率下载视频 1 yt-dlp -f "best[height<=480]" <video_url>
组合格式下载特定质量视频 1 yt-dlp -f 'bestvideo[height<=480]+bestaudio/best[height<=480]' <video_url>
1 yt-dlp -f "bv+ba/b" <video_url>
下载可用的最差视频质量：
1 yt-dlp -f "wv*+wa/w" <video_url>
交互式下载视频
使用 -f – 标志以交互方式选择每个视频的格式。
这将提示您提供可用格式的列表，以及它们的 ID、扩展名、分辨率、文件大小和音频/视频编解码器。
要下载特定格式，请键入文件的 ID，然后按 Enter。
下载默认选择，请按 Enter 键而不键入任何内容。
要退出交互式格式选择提示，请按 Ctrl+C
使用格式 ID 下载视频
如果想下载同一视频的多种格式，可以使用逗号作为分隔符。
例如，使用 -f 22,17,18 将下载所有这三种格式（前提是它们可用）。
数字22、17和18对应于各个视频格式的ID。这些 ID 在 yt-dlp 的输出中称为“格式代码”。可以使用以下任一命令列出可用格式来发现这些 ID：
1 yt-dlp --list-formats https://www.youtube.com/watch?v=t5b20oLaIaw # 或者 yt-dlp -F https://www.youtube.com/watch?v=t5b20oLaIaw
第一列中列出了可用格式的 ID。最佳质量格式通常在末尾找到，通常带有 247 这样的 ID。
因此，要下载最佳质量格式，可以使用以下命令：
1 yt-dlp -f 247 https://www.youtube.com/watch?v=t5b20oLaIaw
如果打算下载多个视频，并且它们不共享相同的可用格式，可以使用斜杠指定优先顺序。
需要注意的是，左侧的格式优先。例如，使用-f 22/17/18意味着它将尝试下载格式 22（如果可用），然后尝试下载格式 17（如果格式 22 不可用），依此类推。
如果没有指定的格式可用，它会通知您没有找到合适的下载格式。请记住，斜杠是左关联的，这意味着在选择过程中优先考虑左侧的格式。
按文件扩展名下载视频
下载指定格式（例如 MP4）的视频
需要注意的是，并非所有视频都可以您所需的格式提供。在这种情况下，yt-dlp 将自动下载最佳可用格式。
1 yt-dlp --format mp4 https://www.youtube.com/watch?v=t5b20oLaIaw # 或者 yt-dlp -f mp4 https://www.youtube.com/watch?v=t5b20oLaIaw
以下命令将下载最佳质量的 MP4 格式文件。如果给定视频的 MP4 格式不可用，它将下载最佳的替代格式
1 yt-dlp -f 'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best' https://www.youtube.com/watch?v=t5b20oLaIaw
1 yt-dlp -f mp4 -o '%(title)s.f%(format_id)s.%(ext)s' https://www.youtube.com/watch?v=t5b20oLaIaw
设置视频下载的大小限制
从播放列表下载多个视频时，可能需要指定大小范围内的视频。例如，要确保不下载小于指定大小（例如 100MB）的视频
1 yt-dlp --min-filesize 100M <playlist_url>
相反，如果希望避免下载大于给定大小的视频，您可以使用：
1 yt-dlp --max-filesize 100M <playlist_url>
还可以选择组合格式选择运算符来下载特定大小的视频。例如，后续命令将下载最佳的纯视频格式，只要它不超过 100MB：
1 yt-dlp -f 'best[filesize<100M]' https://www.youtube.com/watch?v=t5b20oLaIaw
按日期下载视频
据上传日期过滤和下载视频或播放列表的功能，这在处理包含数百个视频的播放列表时非常有用
1 # 要下载在确切日期（例如 2023 年 9 月 30 日）上传的视频 yt-dlp --date 20230930 <URL> # 要下载在特定日期或之前上传的视频： yt-dlp --datebefore 20230930 <URL> # 如果您想获取在特定日期或之后上传的视频： yt-dlp --dateafter 20230930 <URL> # 仅下载最近 6 个月内上传的视频： yt-dlp --dateafter now-6months <URL> # 要下载指定日期范围内的视频，例如2022年9月30日到2023年9月30日，请使用以下命令： yt-dlp --dateafter 20220930 --datebefore 20230930 <URL>
从播放列表下载特定视频
例如，要从播放列表下载 20 个视频，请执行以下命令：
1 yt-dlp --playlist-items 20 <playlist_url>
同时下载视频并将其转换为其他格式。
在以下示例中，该命令将从播放列表中下载第一个视频并将其转换为 .mp3 格式：
1 yt-dlp --playlist-items 1 -x --audio-format mp3 <playlist_url>
同样，要下载多个随机视频，只需指定播放列表中的视频索引，以逗号分隔，如下所示：
1 yt-dlp --playlist-items 2,3,7,10 <playlist_url>
还可以定义要下载的视频范围。要下载从特定视频开始的视频播放列表，例如第 10 个视频，一直持续到最后：
1 yt-dlp --playlist-start 10 <playlist_url>
1 yt-dlp --playlist-start 2 --playlist-end 5 <playlist_url>
设置下载速度
要控制下载速度，您可以使用 -r 选项。例如，以下命令将速度限制为每秒 50 KB：
请注意，速度以每秒字节数指定
将视频直接流式传输到媒体播放器
要将媒体直接流式传输到媒体播放器，您需要使用-o -选项指示 yt-dlp 流式传输到标准输出。此外，您的媒体播放器应该能够从标准输入读取。
您可以通过将 yt-dlp 的输出通过管道传输到媒体播放器来实现此目的。例如，要流式传输到 VLC，您可以使用以下命令：
1 yt-dlp -o - "https://www.youtube.com/watch?v=t5b20oLaIaw" | vlc -
- 如果您安装了 ffmpeg，则在流式传输到标准输出时可以使用“-o - --downloader ffmpeg -f "bv*+ba/b"选项以获得最佳可用质量。
基本命令 下载视频 下载播放列表 下载到特定位置 1 yt-dlp -o '~/Downloads/' <video_url>
并行下载多个视频 在某些情况下，您可能需要从网站或任何其他来源下载多个视频。在这种情况下，您有几个方便的选择：
选项 1：命令中包含多个 URL 进行下载
您可以通过在命令中指定 URL 来下载多个视频，并用空格分隔，如下所示：
选项 2：使用文本文件
从视频下载纯音频
1 yt-dlp -x --audio-format mp3 <video_url>
下载最佳品质 1 yt-dlp -f best <video_url>
下载具体格式 1 yt-dlp -f <format_id> <video_url>
下载最佳音频 1 yt-dlp -f bestaudio <video_url>
常用命令 查看视频信息 限制下载速度 1 yt-dlp -r 500K <video_url>
恢复下载 按日期过滤 1 yt-dlp --date 20250101 <video_url>
按年龄限制过滤 1 yt-dlp --age-limit 18 <video_url>
按标题过滤 1 yt-dlp --match-title "keyword" <playlist_url>
按格式代码下载 1 yt-dlp -f 22,17,18 <video_url>
按文件扩展名下载 1 yt-dlp --format mp4 <video_url>
设置大小限制 1 yt-dlp --min-filesize 100M <playlist_url>
从播放列表下载特定视频 1 yt-dlp --playlist-items 1,3,5 <playlist_url>
下载字幕 显示视频所有字幕 1 yt-dlp --list-subs <video_url>
下载srt字幕 1 yt-dlp --skip-download --write-subs --write-auto-subs --sub-lang en --sub-format ttml --convert-subs srt <video_url>
将字幕内嵌到视频
也可以在下载视频时直接将自动生成的字幕文件内嵌到视频中，这里我选择将中/英文字幕直接内嵌到视频中：
1 yt-dlp --write-auto-sub --sub-lang "zh-Hans,en" --embed-sub <video_url>
转换到指定格式 对字幕格式有特殊要求还可以使用 –convert-subs 将字幕转换为指定格式，以 ass 字幕格式为例：
1 yt-dlp --write-auto-sub --convert-subs=srt --sub-lang "zh-Hans,en" --embed-sub <video_url>
偶尔可能遇到的常见错误。大多数这些问题可以通过将 yt-dlp 更新到最新版本来解决。但是，即使使用更新版本的 yt-dlp，也可能存在一些错误，例如下面列出的错误:
1 yt-dlp --cookies=cookies.txt [视频地址]
修复”Unable to download video data: HTTP Error 403: Forbidden”错误
要修复此错误，只需使用以下命令清除 yt-dlp 缓存即可：
错误： Unable to Open for Writing: [Errno 36] File Name Too Long 如果您在尝试下载名称过长的 视频时遇到此错误，请按照以下步骤解决该问题：
您可能会看到类似于此的错误消息：
1 [youtube] _XEgknKEBws: Downloading webpage ERROR: unable to open for writing: [Errno 36] File name too long: '\xe0\xae\xa8\xe0\xaf\x8b [...] \xe0\xaf\x8d\xe0\xae\x95\xe0\xae\xae\xe0\xaf\x8d-_XEgknKEBws.f136.mp4.part
要解决此错误，只需使用“-o”标志下载您选择的较短名称的视频即可。例如：
1 yt-dlp -f 'bestvideo[ext=mp4]+bestaudio[ext=m4a]' -o video.mp4 <URL>
