命令模板把常用 yt-dlp 参数组合存成一键
什么是命令模板
命令模板是你写好的一段 yt-dlp 命令,其中链接部分用 %(url)s 占位。存好之后,在下载卡片的「命令」Tab 里选这个模板,YTDLnis 会自动把链接替换进去然后运行——相当于预存了一整套参数组合,不用每次手动敲。
怎么创建一个
- 打开下载卡片(音频或视频模式都行)→ 切到命令 Tab
- 新安装时这个 Tab 是空的,点「New Template」按钮
- 在编辑框里写命令:
yt-dlp -f bestaudio -x --audio-format mp3 --embed-thumbnail --add-metadata "%(url)s"
- 给模板起个名字(比如「音频-mp3-带封面」)
- Save
下次在命令 Tab 里就能从下拉列表选这个模板了。也支持多选模板,选中的多个会拼成一条完整命令。
快捷方式(Shortcuts)
命令编辑框里还有 Shortcuts 区域——存常用的参数片段,比如你经常要用的 --cookies-from-browser chrome 或 --sponsorblock-remove sponsor,intro。编辑长命令时点 Shortcut 直接插入参数,不用手动敲。
Shortcuts 和命令模板的区别:Shortcut 是片段、命令模板是完整命令。
导出备份
命令模板可以导出和导入(备份文件里默认包含命令模板),方便:
- 换手机时一起带过去
- 朋友之间共享好用的命令模板
- 版本更新后恢复自己的常用配置
导出格式是简单的 JSON 数组,可以手动编辑或分享。
命令模式 vs 音频 / 视频模式的配置隔离
这是一个容易踩的坑:命令模式下,下载卡片里那些「全局处理设置」(比如处理设置里的 SponsorBlock、Cut、字幕)不会自动生效——因为你在命令里已经完全接管了 yt-dlp 调用。YTDLnis 只会在命令里自动替换 %(url)s、自动带上 Cookies(如果你开了)。
也就是说,命令模板里你必须自己写好所有想要的参数。忘了加 --embed-subs 就不会嵌字幕;忘了加 -f best 就会用 yt-dlp 默认格式。
推荐的入门命令模板
模板一:无损音频 + 封面 + 元数据
yt-dlp -f bestaudio --embed-thumbnail --add-metadata "%(url)s"
模板二:视频 + 多音轨合并
yt-dlp -f "bestvideo+bestaudio/best" --merge-output-format mp4 "%(url)s"
模板三:下载字幕但不嵌
yt-dlp -f best --write-subs --sub-langs "zh,en" "%(url)s"
先用终端里跑通一次,再存成模板。