3步搞定本地歌词:ZonyLrcToolsX免费批量下载歌词实操指南

3步搞定本地歌词:ZonyLrcToolsX免费批量下载歌词实操指南

3步搞定本地歌词:ZonyLrcToolsX免费批量下载歌词实操指南

【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX

前阵子帮朋友整理车载音乐,他的 U 盘里躺着 300 多首从各个渠道攒下来的歌。到了车里一放,播放器歌词栏干干净净,一路哼歌全靠猜。他试着手动补歌词:搜索、复制、保存、改名,20 分钟只搞定 3 首。照这个速度,300 首得耗上一整天。后来我给他推荐了开源工具ZonyLrcToolsX——一个能批量下载歌词的跨平台命令行软件。一杯茶的工夫,U 盘里所有歌曲的.lrc歌词文件就齐了。这篇文章就把我的完整使用过程拆给你看。

它到底是什么:给音乐库请一位"歌词管理员"

把 ZonyLrcToolsX 想象成一位细心的图书管理员:它会自动翻遍你整个音乐文件夹,为每一本书(歌曲)找到配套的"书签"(歌词),并整齐地放回原位。你只需要下达一次指令,剩下的事它全包了。

它最拿手的三件事:

能力具体表现
🎵 四大平台聚合同时对接网易云、QQ 音乐、酷狗、酷我四家的歌词库,广撒网
🔁 自动切换兜底一个平台找不到,立刻换下一个,直到命中为止
⚡ 批量加多线程一次扫描整个文件夹,还能多线程并行,几百首歌几分钟跑完

对于本地音乐文件,它会先用 Taglib 读取歌曲内嵌的标签信息(歌手、歌名),信息不全时再用文件名解析,双保险提升匹配准确率。

第一次上手:从安装到跑通第一条命令

第一步:获取软件

如果你用 Arch Linux 及其衍生发行版,可以直接从 AUR 安装:

yay -S zonylrctoolsx-bin

其他系统的朋友,先克隆仓库再自行构建:

git clone https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX

Windows 用户拿到的是ZonyLrcTools.Cli.exe,Linux/macOS 用户对应ZonyLrcTools.Cli,下文统一写作ZonyLrcTools.Cli

第二步:跑通第一条下载命令

打开终端,进入音乐文件夹所在位置,执行:

ZonyLrcTools.Cli download -d "你的音乐文件夹路径" -l

这条命令做了三件事:扫描-d指定目录下的所有音乐文件(默认支持 mp3、flac、wav、m4a、ogg、opus 等常见格式),为每首歌在四大平台中搜索匹配的歌词,然后生成同名.lrc文件放回原目录。

常用参数一表看懂:

参数作用示例
-d, --dir指定扫描的目录-d "D:\CarMusic"
-l, --lyric下载歌词文件-l
-a, --album同时下载专辑封面-a
-n, --number并行线程数,默认 1-n 8
-sc, --scanner扫描器:local / netease / csv-sc netease
-o, --output歌词输出路径,默认DownloadedLrc-o "D:\LrcOut"
-p, --pattern输出文件名模板-p "{Artist} - {Name}.lrc"
-f, --fileCSV 歌单文件路径-f "歌单.csv"
-s, --song-list-id网易云歌单 ID,多个用分号隔开-s "7224428149"

有一点要提醒:-l-a至少要指定一个,否则程序会提示你补参数。

如果你的首选平台是网易云,会看到扫码登录提示。掏出手机用网易云 App 扫一下,就能下载高质量歌词资源了:

第三步:查看结果

跑完回到音乐文件夹,你会发现每首歌旁边都多了一个同名.lrc文件。播放器(如 foobar2000、网易云本地导入等)会自动识别并显示歌词,车载系统的效果也一样。

进阶玩法:把工具用到极致

玩法一:多线程加速,几百首歌几分钟搞定

音乐库大就加线程数,实测 500 首歌用 8 线程通常 5~10 分钟跑完:

ZonyLrcTools.Cli download -d "音乐文件夹" -l -n 8

玩法二:直接抓取网易云歌单

不用本地文件也能下——把网易云歌单 ID 填进去,程序会按歌单内容逐个下载歌词:

ZonyLrcTools.Cli download -sc netease -o "D:\LrcOut" -s "7224428149" -l

注意:使用非本地扫描器时,-o输出目录必须存在,否则会直接报错。

玩法三:CSV 歌单批量处理

手头有特定歌单(比如学习向、运动向)?整理成 CSV 文件,一行一首,一次搞定:

ZonyLrcTools.Cli download -f "歌单.csv" -l

玩法四:顺手解开.ncm加密文件

网易云下载的.ncm文件很多播放器不认,util子命令可以批量解密转成普通格式:

ZonyLrcTools.Cli util -s "文件或文件夹路径"

玩法五:用配置文件定制歌词

所有下载行为都可以在 src/ZonyLrcTools.Cli/config.yaml 里调整,几个高频选项:

  • 翻译歌词isEnableTranslation: true开启双语,isOnlyOutputTranslation可只保留译文,配合isOneLine把双语合并成一行,适合学外语。
  • 罗马音输出:网易云下载器支持isEnableRomanOutput,学日语歌的朋友会喜欢。
  • 搜索深度:把某个平台配置里的depth调大,能命中更多冷门歌曲,代价是搜索变慢。
  • 跳过已有歌词isSkipExistLyricFiles: true,重复扫描不覆盖已有文件。
  • 编码与换行fileEncoding设成utf-8lineBreak按系统选\n\r\n,避免乱码。

常见问题与避坑清单

  • 提示"请至少指定一个下载选项"?-l(歌词)和-a(专辑图)里至少选一个。
  • 某些歌死活匹配不上?把对应平台的depth调大,或检查歌曲标签是否完整;标签残缺时,程序会退回用文件名解析。
  • 已有歌词的歌曲被覆盖?在配置里打开isSkipExistLyricFiles
  • 下载出来是乱码?检查fileEncodinglineBreak是否与你的播放器兼容。
  • 网易云需要扫码?这是正常流程,扫码登录后能拿到质量更高的歌词,属预期行为。
  • 想调整平台优先级?config.yaml的 lyric 插件列表里修改priority,数字越小越优先,改成-1可临时禁用某个平台。

想深入了解实现细节的开发者,可以看这几处:歌词下载模块在 src/ZonyLrcTools.Common/Lyrics/Providers/,标签识别模块在 src/ZonyLrcTools.Common/TagInfo/,官方文档在 docs/zh_CN.md。

现在就去试试

从"一首一首手动找"到"一条命令批量搞定",差的只是一个 ZonyLrcToolsX。无论你是要整理个人音乐库、准备车载歌单,还是想给外语学习素材配字幕,它都能帮你把繁琐的重复劳动压缩成几分钟。

动手吧:装好软件,复制上面那条download -d ... -l命令,把路径换成你的音乐文件夹,回车。等进度条走完,你的每一首歌就都有歌词陪伴了。

【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考