ytdl-sub项目：自定义在线视频下载文件命名方案解析

背景介绍

ytdl-sub是一个强大的在线视频下载和自动化管理工具，它允许用户通过配置文件来自定义下载内容和存储方式。在实际使用中，很多用户希望摆脱默认的"s01.e001"这种剧集命名格式，转而采用更直观的"yyyy-mm-dd - 标题 (ID).扩展名"的命名方式。

核心配置解析

配置文件结构

ytdl-sub使用YAML格式的配置文件，主要包含两个部分：

1. 全局配置(configuration)：设置权限掩码、日志存储等基础参数
2. 预设配置(presets)：定义视频下载和处理的各类规则

命名方案关键参数

要实现自定义命名，需要关注以下几个关键配置项：

1. tv_show_directory：设置视频存储的基础路径
2. season_by_year__episode_by_month_day：按年月日组织视频的预设
3. 文件命名变量：支持使用日期、标题、ID等变量组合

具体实现方案

修改预设配置

在预设配置中，可以通过覆盖默认变量来实现自定义命名：

base:
  preset:
    - "Jellyfin TV Show by Date"
    - "best_video_quality"
    - "tv_show_paths"
    - "season_by_year__episode_by_month_day"
  
  # 添加命名格式覆盖
  overrides:
    episode_title: "{upload_date_standard} - {title} ({uid})"
    episode_filename: "{episode_title}.{ext}"

变量说明

• {upload_date_standard}：标准格式的上传日期(YYYY-MM-DD)
• {title}：视频标题
• {uid}：视频唯一ID
• {ext}：文件扩展名

高级技巧

1. 日期格式调整：可以通过日期格式化函数调整日期显示方式
2. 标题净化：添加标题净化规则，移除特殊字符
3. 多语言支持：配置提取特定语言的元数据

常见问题解决

1. 变量不生效：检查变量拼写是否正确，确保在正确的覆盖层级
2. 特殊字符问题：使用净化函数处理标题中的特殊字符
3. 日期格式异常：确认视频源提供了正确的上传日期信息

最佳实践建议

1. 先在测试目录运行验证命名效果
2. 保留原始配置文件备份
3. 逐步调整命名规则，避免一次性做太多修改
4. 考虑不同视频源的元数据差异

通过合理配置ytdl-sub的命名规则，用户可以轻松实现符合个人偏好的视频文件组织方式，大幅提升媒体库的管理效率。