如何在ytdl-sub中获取视频格式列表信息

背景介绍

ytdl-sub是一个基于yt-dlp的视频下载工具，提供了更高级的配置和自动化功能。在实际使用中，我们经常需要了解视频的可用格式信息，以便选择合适的下载参数。本文将详细介绍如何在ytdl-sub中启用视频格式列表输出功能。

问题分析

许多用户习惯在命令行中使用yt-dlp的--list-formats参数来查看视频的可用格式信息。当迁移到ytdl-sub时，可能会遇到以下困惑：

1. 直接在ytdl_options中添加list-formats参数无效
2. 格式排序参数format-sort也不起作用
3. 无法在日志中看到预期的格式列表输出

这是因为ytdl-sub使用的是yt-dlp的Python API接口，而非直接调用命令行参数，两者的参数命名和格式存在差异。

正确配置方法

要在ytdl-sub中正确启用格式列表功能，需要使用Python API的参数名称和格式：

ytdl_options:
  listformats: true  # 启用格式列表输出
  simulate: false    # 禁用模拟模式(实际下载)
  format_sort:       # 格式排序参数(注意是下划线而非横线)
    - res:1080
    - +codec:avc:opus

关键点说明：

1. listformats替代了--list-formats，使用驼峰命名而非横线分隔
2. simulate: false替代了--no-simulate，使用布尔值而非否定参数
3. format_sort替代了--format-sort，参数值使用YAML列表格式

参数详解

listformats参数

启用后会在日志中输出视频的可用格式列表，包括：

• 格式ID
• 扩展名
• 分辨率
• 编解码器
• 文件大小
• 备注信息

这对于调试和选择合适的下载格式非常有帮助。

format_sort参数

格式排序参数允许自定义视频格式的优先级，常见用法包括：

• 优先选择1080p分辨率
• 偏好特定的编解码器组合
• 排除某些不想要的格式

在YAML配置中，应该使用列表形式指定多个排序条件。

实际应用建议

1. 调试阶段：建议开启listformats以确认视频的可用格式
2. 生产环境：可以关闭此功能以减少日志输出
3. 格式选择：结合format和format_sort参数可以精确控制下载的格式

总结

理解ytdl-sub使用Python API而非命令行接口这一关键点，可以帮助用户正确配置各种参数。通过本文介绍的配置方法，用户可以轻松获取视频格式信息，并实现更精确的下载控制。记住参数命名的差异和YAML的语法要求，就能避免大多数配置问题。