文件名模板让下载文件自动按规则命名

为什么要用文件名模板

默认情况下 YTDLnis 把文件命名为「上传者 - 标题」。你可以改得更适合自己的整理习惯：加日期、加分辨率、加播放列表名、按作者分子目录……模板系统给了 yt-dlp 所有的输出标签。

基础语法

模板里用 %(标签名)s 表示「插入某个元数据字段」，中间可以加普通字符（空格、短横线、方括号等）。

常用标签一览

实用模板示例

%(uploader)s - %(title)s           # 默认，和内置一样
[%(upload_date)s] %(title)s        # 加上传日期
%(playlist_index)02d - %(title)s   # 播放列表序号 - 标题（两位数补零）
%(artist)s - %(album)s/%(track)s   # 音乐专辑结构，自动建子目录
%(webpage_url_domain)s/%(title)s   # 按来源网站分子目录

注意 YTDLnis 会自动在模板末尾加 %(ext)s 扩展名，你不用自己写。

限制长度

Android 文件名有长度上限（通常 255 字节），标题太长时会报错。用 .170B 这样的格式限制字段长度：

%(uploader).30B - %(title).170B

意思是上传者最多 30 字节、标题最多 170 字节。超过部分会被截断。这也是 YTDLnis 默认模板用的写法。

保存常用模板

在下载卡片里编辑模板时，填完后点「Save」存为「我的模板」，下次直接从下拉选。也可以在「更多 → 设置 → Folders」里分别配置视频和音频的默认文件名模板。

预览功能

编辑时 YTDLnis 会实时显示当前模板对正在下载的这个条目渲染出来的文件名预览，确保你写的模板是对的再下载。