批量参数

有些参数是只有批量下载时才可以使用的

启用批量下载

• 参数 -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
• 配置项 batch.with_section
• 默认值 False

指定稿件发布时间范围

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

• 配置项 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