yt-dlp进度模板自定义指南：实现个性化下载进度显示

进度模板基础概念

yt-dlp作为一款强大的视频下载工具，提供了--progress-template参数允许用户自定义下载进度显示格式。这个功能对于希望获得特定进度信息显示风格的用户非常有用。

默认进度显示分析

默认情况下，yt-dlp显示的进度信息格式为：

[download]  38.6% of   25.97MiB at    2.79MiB/s ETA 00:05

包含以下关键信息：

• 下载百分比
• 文件总大小
• 当前下载速度
• 预计剩余时间

自定义模板实现原理

yt-dlp的进度模板系统基于两个核心对象：

1. info对象：包含视频的元数据信息
2. progress对象：包含下载进度相关数据

通过模板语法%(object.key)s可以访问这些对象的属性。

常用进度属性

虽然官方文档不够完善，但通过实践可以确定以下常用属性：

1. 下载百分比：

   • progress._percent：百分比数值（如38.6）
   • progress._percent_str：带百分号的字符串（如"38.6%"）

2. 时间相关：

   • progress.eta：预计剩余时间（秒）
   • progress.elapsed：已用时间（秒）

3. 大小相关：

   • progress.downloaded_bytes：已下载字节数
   • progress.total_bytes：总字节数
   • progress.speed：当前下载速度（字节/秒）

自定义模板示例

要实现类似"Progress: 38/100; Time remaining: 5s"的显示效果，可以使用以下模板：

--progress-template "Progress: %(progress._percent)d/100; Time remaining %(progress.eta|0)ss"

注意事项

1. 以_开头的属性（如_percent）是内部属性，可能在未来的版本中发生变化
2. 更稳定的做法是自行计算百分比（下载字节数/总字节数*100），但这需要脚本支持
3. 模板中的|0是过滤器，用于将ETA值转换为整数

进阶技巧

对于更复杂的显示需求，可以考虑：

1. 结合多个属性创建复合显示
2. 使用条件判断显示不同状态
3. 添加颜色或其他格式化效果（如果终端支持）

通过灵活运用进度模板，用户可以打造完全符合自己需求的下载进度显示界面，提升使用体验。