资源选择参数

这里有一些参数专用于资源选择，你可以告诉我你需要哪些资源，比如弹幕、音频、视频等等。

仅下载视频流

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

TIP

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

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

仅下载音频流

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

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

不生成弹幕文件

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

仅生成弹幕文件

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

不生成字幕文件

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

仅生成字幕文件

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

选择字幕语言

• 参数 --subtitle-languages
• 默认值 all（下载所有可用字幕）

使用逗号分隔语言代码，例如 zh 仅选择中文，zh,en 选择中文和英文。常用语言代码如下：

• zh：中文
• en：英文
• ja：日文
• ko：韩文
• es：西班牙文
• pt：葡萄牙文
• fr：法文
• de：德文
• ru：俄文

匹配不区分大小写，并包含地区、文字及 AI 变体：例如 zh 包含 zh-CN、zh-Hans、zh-Hant、ai-zh，en 包含 en-US、ai-en。指定更具体的代码可缩小范围，例如 zh-Hans 选择简体中文，ai-zh 仅选择自动生成的中文字幕。

生成媒体元数据文件

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

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

仅生成媒体元数据文件

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

不生成视频封面

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

TIP

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

生成视频流封面时单独保存封面

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

仅生成视频封面

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

不生成章节信息

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

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

配置项

与命令行界面完全不同，配置文件可以直接表明你要下载的资源类型，比如：

yutto.toml

[resource]
require_audio = false
require_subtitle = false
require_danmaku = false

如上配置表明了你不需要音频、字幕和弹幕资源。

具体配置项如下：

是否需要视频流

• 配置项 resource.video_only
• 默认值 True

是否需要音频流

• 配置项 resource.require_audio
• 默认值 True

是否需要弹幕

• 配置项 resource.require_danmaku
• 默认值 True

是否需要字幕

• 配置项 resource.require_subtitle
• 默认值 True

字幕语言选择

• 配置项 resource.subtitle_languages
• 默认值 None（下载所有可用字幕）

空数组 [] 表示不选择任何字幕。

是否需要媒体元数据

• 配置项 resource.require_metadata
• 默认值 False

是否需要视频封面

• 配置项 resource.require_cover
• 默认值 True

是否需要章节信息

• 配置项 resource.require_chapter_info
• 默认值 True

生成视频流封面时单独保存封面

• 配置项 resource.save_cover
• 默认值 False