参考手册
输出模板变量
yt-dlp 输出文件名模板可用变量完整列表
以下变量可在 -o / outtmpl 模板中使用，格式为 %(变量名)s。
| 变量 | 说明 | 示例值 |
|---|
%(id)s | 视频 ID | BV1xx411c7mD |
%(title)s | 视频标题 | 我的视频 |
%(fulltitle)s | 完整标题 | 我的视频 |
%(alt_title)s | 备用标题 | - |
%(description)s | 视频描述 | 这是视频简介... |
%(ext)s | 文件扩展名 | mp4 |
%(display_id)s | 用于显示的 ID | BV1xx411c7mD |
%(url)s | 视频 URL | https://... |
%(webpage_url)s | 页面 URL | https://... |
| 变量 | 说明 | 示例值 |
|---|
%(uploader)s | 上传者名称 | ExampleUser |
%(uploader_id)s | 上传者 ID | UC1234 |
%(uploader_url)s | 上传者主页 | https://... |
%(channel)s | 频道名 | 我的频道 |
%(channel_id)s | 频道 ID | UC1234 |
%(channel_url)s | 频道 URL | https://... |
%(creator)s | 创建者 | ExampleUser |
%(artist)s | 艺术家 | 歌手名 |
| 变量 | 说明 | 示例值 |
|---|
%(upload_date)s | 上传日期 (YYYYMMDD) | 20240115 |
%(upload_date>%Y-%m-%d)s | 格式化日期 | 2024-01-15 |
%(timestamp)s | Unix 时间戳 | 1705276800 |
%(duration)s | 视频时长（秒） | 180 |
%(duration_string)s | 时长字符串 | 3:00 |
| 变量 | 说明 | 示例值 |
|---|
%(view_count)s | 播放量 | 12345 |
%(like_count)s | 点赞数 | 678 |
%(dislike_count)s | 踩数 | 12 |
%(comment_count)s | 评论数 | 89 |
%(repost_count)s | 转发数 | 34 |
%(average_rating)s | 平均评分 | 4.5 |
| 变量 | 说明 | 示例值 |
|---|
%(resolution)s | 分辨率 | 1920x1080 |
%(width)s | 宽度（像素） | 1920 |
%(height)s | 高度（像素） | 1080 |
%(fps)s | 帧率 | 30 |
%(vcodec)s | 视频编码 | avc1.640028 |
%(acodec)s | 音频编码 | mp4a.40.2 |
%(format)s | 格式描述 | 137 - 1080p |
%(format_id)s | 格式 ID | 137 |
%(filesize)s | 文件大小（字节） | 12345678 |
%(filesize_approx)s | 预估文件大小 | 12000000 |
%(tbr)s | 总比特率 | 1200 |
%(abr)s | 音频比特率 | 128 |
%(vbr)s | 视频比特率 | 1072 |
| 变量 | 说明 | 示例值 |
|---|
%(playlist)s | 播放列表名或 ID | PLxxx |
%(playlist_title)s | 播放列表标题 | 我的收藏 |
%(playlist_id)s | 播放列表 ID | PLxxx |
%(playlist_index)s | 列表中的序号 | 3 |
%(playlist_count)s | 列表总数 | 15 |
%(n_entries)s | 条目总数 | 15 |
%(playlist_uploader)s | 列表创建者 | UserName |
# 标题最多 50 字符
%(title).50s
# 序号补零到 3 位
%(playlist_index)03d
# 自定义日期格式
%(upload_date>%Y-%m-%d)s # 2024-01-15
%(upload_date>%Y年%m月%d日)s # 2024年01月15日
# 如果值不存在则使用默认值
%(artist|Unknown Artist)s
%(playlist_title|单视频)s
# 通用视频
"%(title)s [%(id)s].%(ext)s"
# 音乐收藏
"%(artist|%(uploader)s)s/%(title)s.%(ext)s"
# 频道归档
"%(channel)s/%(upload_date>%Y-%m-%d)s - %(title).80s [%(id)s].%(ext)s"
# 播放列表
"%(playlist_title)s/%(playlist_index)03d - %(title)s.%(ext)s"
# bilibili 分P
"%(title)s/P%(playlist_index)02d - %(title)s.%(ext)s"