• 参数 -n 或 --num-workers
• 默认值 8

与 bilili 不同的是，yutto 并不是使用多线程实现并行下载，而是使用协程实现的，本参数限制的是最大的并行 Worker 数量。

• 参数 -q 或 --video-quality
• 可选值 127 | 126 | 125 | 120 | 116 | 112 | 100 | 80 | 74 | 64 | 32 | 16
• 默认值 127

清晰度对应关系如下

并不是说指定某个清晰度就一定会下载该清晰度的视频，yutto 只会尽可能满足你的要求，如果不存在指定的清晰度，yutto 就会按照默认的清晰度搜索机制进行调节，比如指定清晰度为 80，首先会依次降清晰度搜索 74、64、32、16，如果依然找不到合适的则继续升清晰度搜索 100、112、116、120、125、126、127。

值得注意的是，目前杜比视界视频只能简单下载音视频流并合并，合并后并不能达到在线观看的效果。

• 参数 -aq 或 --audio-quality
• 可选值 30251 | 30255 | 30250 | 30280 | 30232 | 30216
• 默认值 30251

码率对应关系如下

码率自动调节机制与视频清晰度一致，也采用先降后升的匹配机制。

• 参数 --vcodec
• 下载编码可选值 "av1" | "hevc" | "avc"
• 保存编码可选值 FFmpeg 所有可用的视频编码器
• 默认值 "avc:copy"

该参数略微复杂，前半部分表示在下载时优先选择哪一种编码的视频流，后半部分则表示在合并时如何编码视频流，两者使用 : 分隔。

值得注意的是，前半的下载编码只是优先下载的编码而已，如果不存在该编码，则会根据 --download-vcodec-priority 自动选择其余编码，如未设置 --download-vcodec-priority，则会类似视频清晰度调节机制先降序后升序的方式来选择。

而后半部分的参数如果设置成非 copy 的值则可以确保在下载完成后对其进行重新编码，而且不止支持 av1、hevc 与 avc，只要你的 FFmpeg 支持的视频编码器，它都可以完成。

• 参数 --acodec
• 下载编码可选值 "mp4a"
• 保存编码可选值 FFmpeg 所有可用的音频编码器
• 默认值 "mp4a:copy"

详情同视频编码。

• 参数 --download-vcodec-priority
• 默认值 "auto"
• 可选值 "auto" 或者使用 , 分隔的下载编码列表，如 "hevc,avc,av1"

当使用默认值 "auto" 时，yutto 会类似视频清晰度调节机制先降序后升序的方式来选择。

当使用自定义下载编码列表时，yutto 会严格按照列表中的顺序进行选择，如果不存在则会认为该视频无视频流。

Warning

如若设置本参数，请总是将 --download-vcode-priority 首选编码作为 --vcodec 的前半部分，否则可能会导致下载失败。

• 参数 --output-format
• 可选值 "infer" | "mp4" | "mkv" | "mov"
• 默认值 "infer"

在至少包含视频流时所使用的输出格式，默认选值 "infer" 表示自动根据情况进行推导以保证输出的可用，推导规则如下：

• 如果输出包含音频流且音频流编码为 "fLaC"，则输出格式为 "mkv"，因为 "mp4" 尚不支持 "fLaC" 编码
• 否则为 "mp4"

• 参数 --output-format-audio-only
• 可选值 "infer" | "aac" | "mp3" | "flac" | "mp4" | "mkv" | "mov"
• 默认值 "infer"

在仅包含音频流时所使用的输出格式，默认选值 "infer" 表示自动根据情况进行推导以保证输出的可用，推导规则如下：

• 如果音频流编码为 "fLaC"，则输出格式为 "flac"
• 否则为 "aac"

Note

并不是仅仅在指定 --audio-only 时才会仅仅包含视频流，有些视频是仅包含音频流的，此时即便不指定 --audio-only 选项也会按照本选项的格式进行输出。

• 参数 -df 或 --danmaku-format
• 可选值 "ass" | "xml" | "protobuf"
• 默认值 "ass"

B 站提供了 xml 与 protobuf 两种弹幕数据接口，xml 接口为旧接口，弹幕数上限较低，protobuf 接口相对较高，但不登录情况下只能获取很少的弹幕

为了确保无论是否登录都能获取最多的弹幕，yutto 在登录时会下载 protobuf 源数据，在未登录时会下载 xml 源数据，并将其转换为主流播放器支持的 ass 格式

如果你不喜欢 yutto 自动转换的效果，可以选择输出格式为 xml 或 protobuf，手动通过一些工具进行转换，比如 yutto 和 bilili 所使用的 biliass，或者使用 us-danmaku 进行在线转换。

如果你不想下载弹幕，只需要使用参数 --no-danmaku 即可。

• 参数 -bs 或 --block-size
• 默认值 0.5

以 MiB 为单位，为分块下载时各块大小，不建议更改。

• 参数 -w 或 --overwrite
• 默认值 False

• 参数 -x 或 --proxy
• 可选值 "auto" | "no" | <https?://url/to/proxy/server>
• 默认值 "auto"

设置代理服务器，默认是从环境变量读取，no 则为不设置代理，设置其它 http/https url 则将其作为代理服务器。

• 参数 -d 或 --dir
• 默认值 "./"

• 参数 --tmp-dir
• 默认值是“存放根目录”即 -d, --dir 的值

• 参数 -c 或 --sessdata
• 默认值 ""

设置 Cookies 后你才可以下载更高清晰度以及更多的剧集，当你传入你的大会员 SESSDATA 时（当然前提是你是大会员），你就可以下载大会员可访问的资源咯。

另外，由于 SESSDATA 中可能有特殊符号，所以传入时你可能需要使用双引号来包裹

yutto <url> -c "d8bc7493%2C2843925707%2C08c3e*81"

当然，示例里的 SESSDATA 是无效的，请使用自己的 SESSDATA。

• 参数 -tp 或 --subpath-template
• 可选参数变量 title | id | name | username | series_title | pubdate | download_date | owner_uid （以后可能会有更多）
• 默认值 "{auto}"

通过配置子路径模板可以灵活地控制视频存放位置。

默认情况是由 yutto 自动控制存放位置的。比如下载单个视频时默认就是直接存放在设定的根目录，不会创建一层容器目录，此时自动选择了 {name} 作为模板；而批量下载时则会根据视频层级生成多级目录，比如番剧会是 {title}/{name}，首先会在设定根目录里生成一个番剧名的目录，其内才会存放各个番剧剧集视频，这样方便了多个不同番剧的管理。当然，如果你仍希望将番剧直接存放在设定根目录下的话，可以修改该参数值为 {name}即可。

另外，该功能语法由 Python format 函数模板语法提供，所以也支持一些高级的用法，比如 {id:0>3}{name}，此外还专门为时间变量 🕛 增加了自定义时间模板的语法 {pubdate@%Y-%m-%d %H:%M:%S}，默认时间模板为 %Y-%m-%d。

值得注意的是，并不是所有变量在各种场合下都会提供，比如 username, owner_uid 变量当前仅在 UP 主全部投稿视频/收藏夹/稍后再看才提供，在其它情况下不应使用它。各变量详细作用域描述见下表：

Note

未来可能会对路径变量及默认路径模板进行调整

• 参数 -af 或 --alias-file
• 默认值 None

指定别名文件路径，别名文件中存放一个别名与其对应的 url，使用空格或者 = 分隔，示例如下：

tensura1=https://www.bilibili.com/bangumi/play/ss25739/
tensura2=https://www.bilibili.com/bangumi/play/ss36170/
tensura-nikki=https://www.bilibili.com/bangumi/play/ss38221/

比如将上述内容存储到 ~/.yutto_alias，则通过以下命令即可解析该文件：

yutto tensura1 --batch --alias-file='~/.yutto_alias'

当参数值为 - 时，会从标准输入中读取：

cat ~/.yutto_alias | yutto tensura-nikki --batch --alias-file -

当前仅支持 premiered

• 参数 --metadata-format-premiered
• 默认值 "%Y-%m-%d"
• 常用值 "%Y-%m-%d %H:%M:%S"

• 参数 --vip-strict
• 默认值 False

• 参数 --login-strict
• 默认值 False

• 参数 --download-interval
• 默认值 0

设置两话之间的下载间隔（单位为秒），避免短时间內下载大量视频导致账号被封禁

• 参数 --banned-mirrors-pattern
• 默认值 None

使用正则禁用特定镜像，比如 --banned-mirrors-pattern "mirrorali" 将禁用 url 中包含 mirrorali 的镜像

• 参数 --no-color
• 默认值 False

• 参数 --no-progress
• 默认值 False

• 参数 --debug
• 默认值 False

• 参数 --video-only
• 默认值 False

Note

这里「仅下载视频流」是指视频中音视频流仅选择视频流，而不是仅仅下载视频而不下载弹幕字幕等资源，如果需要取消字幕等资源下载，请额外使用 --no-danmaku 等参数。

「仅下载音频流」也是同样的。

• 参数 --audio-only
• 默认值 False

仅下载其中的音频流，保存为 .aac 文件。

• 参数 --no-danmaku
• 默认值 False

• 参数 --danmaku-only
• 默认值 False

• 参数 --no-subtitle
• 默认值 False

• 参数 --subtitle-only
• 默认值 False

• 参数 --with-metadata
• 默认值 False

目前媒体元数据生成尚在试验阶段，可能提取出的信息并不完整。

• 参数 --metadata-only
• 默认值 False

• 参数 --no-cover
• 默认值 False

[!NOTE]

当前仅支持为包含视频流的视频生成封面。

• 参数 --no-chapter-info
• 默认值 False

不生成章节信息，包含 MetaData 和嵌入视频流的章节信息。

• 参数 --danmaku-font-size
• 默认值 video_width / 40

• 参数 --danmaku-font
• 默认值 "SimHei"

• 参数 --danmaku-opacity
• 默认值 0.8

• 参数 --danmaku-display-region-ratio
• 默认值 1.0

• 参数 --danmaku-speed
• 默认值 1.0

• 参数 --danmaku-block-top
• 默认值 False

• 参数 --danmaku-block-bottom
• 默认值 False

• 参数 --danmaku-block-scroll
• 默认值 False

• 参数 --danmaku-block-reverse
• 默认值 False

• 参数 --danmaku-block-fixed
• 默认值 False

• 参数 --danmaku-block-special
• 默认值 False

• 参数 --danmaku-block-colorful
• 默认值 False

• 参数 "--danmaku-block-keyword-patterns
• 默认值 None

按关键词屏蔽，支持正则，使用 , 分隔

• 参数 -b 或 --batch
• 默认值 False

只需要 yutto --batch <url> 即可启用批量下载功能。

• 参数 -p 或 --episodes
• 默认值 1~-1（也即全选）

也就是选集咯，其语法是这样的

• <p1> 单独下某一剧集
  • 支持负数来选择倒数第几话
  • 此外还可以使用 $ 来代表 -1
• <p_start>~<p_end> 使用 ~ 可以连续选取（如果起始为 1，或者终止为 -1 则可以省略）
• <p1>,<p2>,<p3>,...,<pn> 使用 , 可以不连续选取

emmm，直接看的话大概并不能知道我在说什么，所以我们通过几个小例子来了解其语法

# 假设要下载一个具有 24 话的番剧
# 如果我们只想下载第 3 话，只需要这样
yutto <url> -b -p 3
# 那如果我想下载第 5 话到第 7 话呢，使用 `~` 可以连续选中
yutto <url> -b -p 5~7
# 那我想下载第 12 话和第 17 话又要怎么办？此时只需要 `,` 就可以将多个不连续的选集一起选中
yutto <url> -b -p 12,17
# 那我突然又想将刚才那些都选中了呢？还是使用 `,` 呀，将它们连在一起即可
yutto <url> -b -p 3,5~7,12,17
# 嗯，你已经把基本用法都了解过了，很简单吧～
# 下面是一些语法糖，不了解也完全不会影响任何功能哒～
# 那如果我只知道我想下载倒数第 3 话，而不想算倒数第三话是第几话应该怎么办？
# 此时可以用负数哒～不过要注意的是，这种参数以 `-` 开头参数需要使用 `=` 来连接选项和参数
yutto <url> -b -p=-3
# 那么如果想下载最后一话你可能会想到 `-p=-1` 对吧？不过我内置了符号 $ 用于代表最后一话
# 像下面这样就可以直接下载最后一话啦～
yutto <url> -b -p $
# 为了进一步方便表示一个范围选取，在从第一话开始选取或者以最后一话为终止时可以省略它们
# 这样就是前三话啦（这里与以 `-` 开头类似，以 `~` 开头可能被识别为 $HOME，因此最好也用等号，或者使用引号包裹）
yutto <url> -b -p=~3
# 这样就是后四话啦
yutto <url> -b -p=-4~
# 所有语法都了解完啦，我们看一个稍微复杂的例子
yutto <url> -b -p "~3,10,12~14,16,-4~"
# 很明显，上面的例子就是下载前 3 话、第 10 话、第 12 到 14 话、第 16 话以及后 4 话

下面是一些要注意的问题

1. 这里使用的序号是视频的顺序序号，而不是番剧所标注的第 n 话，因为有可能会出现 第 x.5 话 等等的特殊情况，此时一定要按照顺序自行计数。
2. 参数值里一定不要加空格
3. 参数值开头为特殊符号时最好使用 = 来连接选项和参数，或者尝试使用引号包裹参数
4. 个人空间、视频列表、收藏夹等批量下载暂不支持选集操作

• 参数 -s 或 --with-section
• 默认值 False

• 参数 --batch-filter-start-time 和 --batch-filter-end-time 分别表示开始和结束时间，该区间左闭右开

• 默认 不限制

• 支持的格式

  • %Y-%m-%d
  • %Y-%m-%d %H:%M:%S

  例如仅下载 2020 年投稿的视频，可以这样:

  --batch-filter-start-time=2020-01-01 --batch-filter-end-time=2021-01-01