Tartube视频下载工具文件命名配置详解

问题背景

在使用Tartube 2.5.100版本进行视频下载时，许多用户发现无法按照预期自定义下载文件的命名格式。尽管在"通用下载选项->文件->文件名"设置中配置了自定义命名模板，但实际下载的文件仍然只保留了视频标题作为文件名。

问题根源分析

经过深入调查，发现这个问题并非Tartube本身的缺陷，而是用户对软件配置层级理解不足导致的。Tartube采用了多层级配置系统，其中：

1. 系统级配置：影响整个应用程序的全局设置
2. 下载选项组配置：针对不同下载模式(如经典模式、批量模式等)的特定设置
3. 单个下载项配置：针对特定视频或频道的特殊设置

正确配置步骤

1. 确定当前下载模式

首先需要明确使用的是哪种下载模式，因为不同模式对应不同的配置组：

• 经典模式(Classic Mode)
• 批量模式(Bulk Mode)
• 频道模式(Channel Mode)等

2. 修改对应模式的下载选项

1. 点击菜单栏"编辑 > 系统偏好设置 > 选项 > 下载选项"
2. 在列表中找到与当前使用模式匹配的选项组(如使用经典模式则选择"classic")
3. 点击"编辑"按钮打开详细设置

3. 配置文件名模板

在打开的编辑窗口中：

1. 切换到"文件"标签页
2. 在文件名设置区域选择"自定义"选项
3. 输入符合youtube-dl/yt-dlp规范的命名模板，例如： %(title)s-%(channel)s-%(resolution)s.%(ext)s

4. 显示实际文件名

默认情况下，Tartube的视频列表显示的是视频原始名称而非实际文件名。如需显示实际文件名：

1. 点击菜单栏"编辑 > 系统偏好设置 > 窗口 > 视频"
2. 取消勾选"显示昵称(非视频文件名)"选项

命名模板语法详解

Tartube支持youtube-dl/yt-dlp的标准命名模板语法，常用变量包括：

• %(title)s：视频标题
• %(channel)s：频道名称
• %(upload_date)s：上传日期(YYYYMMDD格式)
• %(resolution)s：视频分辨率
• %(ext)s：文件扩展名

可以自由组合这些变量，添加分隔符如"-"或"_"来创建符合需求的命名格式。

高级配置技巧

1. 多模式配置：可以为不同下载模式设置不同的命名规则
2. 特殊字符处理：在模板中使用[]包裹可能包含特殊字符的部分
3. 日期格式化：通过%(upload_date>%Y-%m-%d)s等方式自定义日期显示格式
4. 长度限制：使用%(title.50)s限制标题显示长度

常见问题排查

如果配置后仍无法正常工作，建议：

1. 检查下载日志中的输出路径参数
2. 确认修改的是当前使用模式的配置组
3. 重启Tartube应用使配置完全生效
4. 测试简单模板如%(title)s-test.%(ext)s验证基本功能

通过以上详细配置，用户可以充分利用Tartube强大的文件命名自定义功能，实现符合个人需求的视频文件管理方案。