跳到正文
yt-dlp

yt-dlp 命令生成器

点选你需要的选项,得到一条完全正确的 yt-dlp 命令,并且已按你的 shell 正确加好引号。不用记 flag,不用在这里装任何东西,也不上传任何东西。

可选。留空的话命令会以 URL 结尾,由你自己填。

你的命令

yt-dlp URL
基本

仅音频会提取声音轨并丢弃视频流。

视频与画质

限制高度上限。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)
重置

为什么需要命令生成器?

yt-dlp 有好几百个选项,而真正有用的那些很少单独起作用:想要 1080p 就得把 format selector 和 merge container 组合起来,而内嵌字幕会悄悄依赖 ffmpeg。这个页面把这些组合都预先处理好了,所以命令第一次就能跑通。

这里每个选项都对应一个真实的 flag,就显示在它旁边,参数手册按某个确定的 yt-dlp 版本记录了全部选项。没有任何功能被藏在付费方案后面。

如何构造一条 yt-dlp 命令

  1. 把想要的视频、播放列表或频道地址粘贴到网址框里。
  2. 选好画质、container、音频格式、字幕以及其他需要的东西。命令会随着你的选择实时更新。
  3. 切到你用的 shell,复制命令,在装好 yt-dlp 的终端里运行。

常见问题

yt-dlp 命令生成器是什么?
它是一个替你写命令的表单。你用日常语言选出想要的效果,它生成完全正确的 yt-dlp 命令行,flag 顺序无误,并按你的 shell 正确加好引号。
使用这个页面需要装什么吗?
用这个页面不需要 —— 它只是生成文字。要运行命令则需要 yt-dlp,凡是涉及合并、转换或内嵌的还需要 ffmpeg。安装指南两者都讲到了。
我能生成哪些 yt-dlp 选项?
大多数人需要的都有:格式与画质、提取音频、字幕、播放列表、片段、SponsorBlock、元数据、文件命名、筛选、网络设置、cookies、直播,以及常见的绕行办法。参数手册里列出了全部。
这些命令在 youtube-dl 上也能用吗?
大部分可以。yt-dlp 保留了 youtube-dl 的选项名,所以简单命令可以互换。--download-sections、--sponsorblock-remove 和 --impersonate 这类较新的选项只有 yt-dlp 才有。
有哪部分是付费的吗?
没有。所有选项、预设和页面都免费。不上传任何东西,没有账号,生成器也没有任何功能是留给付费方案的。