文件名格式

NCMGET 的下载命令支持自定义输出文件名格式,通过 -f, --format 选项指定。

默认模板

默认的文件名格式为:

{name} - {artist}

例如下载歌曲"情绪缓冲区溢出"(歌手:淘气的Roy),生成的文件名为:

情绪缓冲区溢出 - 淘气的Roy.mp3

可用占位符

占位符描述示例值
{id}歌曲ID3374579108
{name}歌曲名称情绪缓冲区溢出
{artist}歌手名称(多位歌手用 / 分隔)淘气的Roy
{album}专辑名称情绪缓冲区溢出
{pic_id}封面图片ID3374579108
{url_id}音频URL对应的ID3374579108
{lrc_id}歌词对应的ID3374579108
{source}数据来源netease

清理规则

文件名中的非法字符会被自动替换为 _。以下字符被视为非法:

<>:"/\|?*

例如,如果歌曲名称包含这些字符,它们将被替换:

原始: What's Your Name?
替换: What_s Your Name_

自定义格式示例

按歌手分组

ncmget song 3374579108 -f "{artist}/{name}"
# 输出: 淘气的Roy/情绪缓冲区溢出.mp3

按专辑分组

ncmget album 372893716 -f "{album}/{artist} - {name}"
# 输出: 情绪缓冲区溢出/淘气的Roy - 情绪缓冲区溢出.mp3

包含ID

ncmget song 3374579108 -f "{id} - {name}"
# 输出: 3374579108 - 情绪缓冲区溢出.mp3

歌手在前

ncmget song 3374579108 -f "{artist} - {name}"
# 输出: 淘气的Roy - 情绪缓冲区溢出.mp3

完整信息

ncmget song 3374579108 -f "{album}/{artist} - {name} [{id}]"
# 输出: 情绪缓冲区溢出/淘气的Roy - 情绪缓冲区溢出 [3374579108].mp3

注意事项

  • 使用 / 可以创建子目录,NCMGET 会自动创建所需的目录结构
  • 占位符区分大小写,必须使用小写
  • 文件扩展名会根据文件类型自动添加(.mp3.lrc.webp 等)