给音乐库补歌词我用这条命令一口气搞定了 500 首歌【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX上个月朋友把一台旧笔记本塞给我说是里面存着大学四年攒下的两千多首歌想让我帮忙整理成能在车里直接放的样子。我打开一看歌是齐的可歌词文件几乎为零——插上 U 盘连到车载系统屏幕上永远只有光秃秃的歌名。那天晚上我花了四个小时手动给前 50 首搜歌词然后果断放弃转头找工具。最后帮我把这件事彻底解决掉的是一个叫ZonyLrcToolsX的开源命令行小工具它对接网易云音乐、QQ 音乐、酷狗、酷我四个平台扫描、匹配、下载、转格式一条龙全程我只敲了一行命令。一句话说清它是什么你可以把它理解成给本地音乐库请了一位自动填词的小助手你把存放音乐的文件夹地址告诉它它会挨个读取每首歌的标签信息歌手、歌名然后去四个主流音乐平台里找对应的 LRC 歌词找到就写回歌曲同目录下播放器下次打开就能直接显示。标签信息不全的时候它还能退一步靠文件名猜双保险。它没有图形界面纯命令行操作但这恰恰是它的优势一条命令扫一整个文件夹几百首歌几十分钟搞定还支持多线程加速。从零安装到第一次成功运行整个上手过程分三步每一步都不需要懂编程。第一步拿到程序本体如果你是 Arch Linux 用户AUR 仓库里已经有现成打包一条命令装好yay -S zonylrctoolsx-bin其他系统可以从项目仓库拉取代码后自行发布或者直接使用已发布的二进制文件git clone https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX第二步确认参数再动手程序最常用的子命令是download核心参数就这几个-d要扫描的音乐文件夹路径-l下载歌词文件-a下载专辑封面可选-n并行线程数默认 1第三步跑起来假设你的音乐都在D:\CarMusic那么ZonyLrcTools.Cli.exe download -d D:\CarMusic -l程序会先扫描目录里所有支持的音乐文件.mp3、.flac、.wav、.m4a、.ogg、.opus读取标签信息然后按配置文件里的平台优先级逐个尝试下载歌词。运行结束时终端会打印一份成绩单成功多少首、跳过多少首纯音乐没有歌词、失败多少首。失败的那几首还会被单独写进一个以「歌词下载失败列表_时间戳」命名的 txt 文件里方便你回头手动处理。下载成功的歌词会以「歌手 - 歌名.lrc」的格式保存在音乐文件旁边播放器自动就能识别。第一次跑通之后你大概就明白这个工具的脾气了。下面是它全部能力的速查地图。能力速查表你想做什么用什么命令/配置关键点给整个文件夹批量补歌词download -d 路径 -l歌词写在歌曲同目录连专辑封面一起下载download -d 路径 -l -a-a与-l可同时用加快大音乐库的处理速度download -d 路径 -l -n 88 个并行线程视机器情况调从 CSV 歌单批量下载download -f 歌单.csv -l需配合-sc csv使用下载网易云某个歌单的全部歌词download -sc netease -s 歌单ID -o 输出目录 -l歌单 ID 用;分隔多个指定歌词文件命名格式-p {Artist} - {Name}.lrc支持歌手/歌名占位符调整平台优先级/搜索深度编辑config.yaml位置在src/ZonyLrcTools.Cli/config.yaml跳过已有歌词的歌配置isSkipExistLyricFiles: true避免重复下载覆盖除了download程序还预留了search、utility、manual等子命令用--help随时可以查看每个命令的说明。新手最容易踩的坑自查清单Q1运行后提示「没有找到任何音乐文件」先确认-d指向的目录里确实有支持的格式mp3/flac/wav/m4a/ogg/opus。另外程序默认是跳过已有.lrc文件的如果你之前手动放过歌词记得在config.yaml里把isSkipExistLyricFiles设为false。Q2歌词匹配到的是同名同歌手但根本不是这一首这是搜索深度的问题。config.yaml里每个平台都有depth参数默认 10值越大搜索结果越多、匹配越准但搜索耗时也会变长。个别冷门歌可以单独调大。Q3下载出来的歌词是乱码检查config.yaml的fileEncoding配置默认是utf-8如果你的播放器对编码敏感可以改成utf-8-bom或者 GBK 系编码程序会负责做编码转换。Q4某个平台一直失败config.yaml中每个平台都有一个priority优先级改成-1可以整体禁用该平台。如果网易云总是失败多半是需要登录——用网易云平台下载时程序会弹出二维码用网易云 APP 扫码授权后就能拿到高质量歌词。Q5歌词想中英双语但显示成了两行config.yaml里isEnableTranslation控制是否下载翻译歌词isOneLine控制双语是否合并为一行isOnlyOutputTranslation可以只输出翻译。按你的播放器习惯组合这三个开关即可。三个进阶玩法玩法一给网易云歌单批量补歌词目标把云端的歌单整个搬到本地还带上歌词。步骤先拿到歌单 ID网易云歌单链接里playlist?id后面的那串数字然后运行ZonyLrcTools.Cli.exe download -sc netease -s 7224428149 -o D:\TempFiles -l首次使用网易云平台时程序会生成二维码用手机扫码登录一次之后就能正常拉取。效果歌单里所有歌曲的歌词按「歌手 - 歌名.lrc」格式落盘到-o指定的目录整个过程不需要先下载任何音频文件。玩法二用 CSV 歌单定向批量处理目标手头有一份特定清单比如活动伴奏曲目表只想处理清单里的歌。步骤按「歌名、歌手、专辑」的格式整理成 CSV然后执行ZonyLrcTools.Cli.exe download -sc csv -f 歌单.csv -l效果工具只处理清单里的歌曲适合不想动整个音乐库、只想给某批特定歌曲补歌词的场景。测试用的样例 CSV 可以在仓库的tests/ZonyLrcTools.Tests/TestData/test.csv里找到。玩法三多线程加速大库处理目标几千首的大音乐库别让程序跑一个通宵。步骤把-n线程数调到机器核心数附近ZonyLrcTools.Cli.exe download -d E:\MusicLibrary -l -n 8效果歌词下载会按并行线程拆分任务处理时间能明显缩短。注意线程数不是越大越好网络请求和磁盘写入才是瓶颈一般 4~8 就够用。让歌词自己长出来折腾完那台旧笔记本后我最大的感触是好的工具不是替你省时间而是让你彻底忘记「原来还需要这件事」。ZonyLrcToolsX 就是这样的存在——装上它配好一次以后新歌入库只需要把文件丢进文件夹、跑一遍命令歌词就自己长出来了。想深入了解它仓库里的docs/zh_CN.md有完整文档歌词下载相关的核心源码在src/ZonyLrcTools.Common/Lyrics/Providers/配置文件说明在src/ZonyLrcTools.Cli/config.yaml。下一个周末试试给你的音乐库做一次彻底的歌词大扫除吧。【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
给音乐库补歌词我用这条命令一口气搞定了 500 首歌【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX上个月朋友把一台旧笔记本塞给我说是里面存着大学四年攒下的两千多首歌想让我帮忙整理成能在车里直接放的样子。我打开一看歌是齐的可歌词文件几乎为零——插上 U 盘连到车载系统屏幕上永远只有光秃秃的歌名。那天晚上我花了四个小时手动给前 50 首搜歌词然后果断放弃转头找工具。最后帮我把这件事彻底解决掉的是一个叫ZonyLrcToolsX的开源命令行小工具它对接网易云音乐、QQ 音乐、酷狗、酷我四个平台扫描、匹配、下载、转格式一条龙全程我只敲了一行命令。一句话说清它是什么你可以把它理解成给本地音乐库请了一位自动填词的小助手你把存放音乐的文件夹地址告诉它它会挨个读取每首歌的标签信息歌手、歌名然后去四个主流音乐平台里找对应的 LRC 歌词找到就写回歌曲同目录下播放器下次打开就能直接显示。标签信息不全的时候它还能退一步靠文件名猜双保险。它没有图形界面纯命令行操作但这恰恰是它的优势一条命令扫一整个文件夹几百首歌几十分钟搞定还支持多线程加速。从零安装到第一次成功运行整个上手过程分三步每一步都不需要懂编程。第一步拿到程序本体如果你是 Arch Linux 用户AUR 仓库里已经有现成打包一条命令装好yay -S zonylrctoolsx-bin其他系统可以从项目仓库拉取代码后自行发布或者直接使用已发布的二进制文件git clone https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX第二步确认参数再动手程序最常用的子命令是download核心参数就这几个-d要扫描的音乐文件夹路径-l下载歌词文件-a下载专辑封面可选-n并行线程数默认 1第三步跑起来假设你的音乐都在D:\CarMusic那么ZonyLrcTools.Cli.exe download -d D:\CarMusic -l程序会先扫描目录里所有支持的音乐文件.mp3、.flac、.wav、.m4a、.ogg、.opus读取标签信息然后按配置文件里的平台优先级逐个尝试下载歌词。运行结束时终端会打印一份成绩单成功多少首、跳过多少首纯音乐没有歌词、失败多少首。失败的那几首还会被单独写进一个以「歌词下载失败列表_时间戳」命名的 txt 文件里方便你回头手动处理。下载成功的歌词会以「歌手 - 歌名.lrc」的格式保存在音乐文件旁边播放器自动就能识别。第一次跑通之后你大概就明白这个工具的脾气了。下面是它全部能力的速查地图。能力速查表你想做什么用什么命令/配置关键点给整个文件夹批量补歌词download -d 路径 -l歌词写在歌曲同目录连专辑封面一起下载download -d 路径 -l -a-a与-l可同时用加快大音乐库的处理速度download -d 路径 -l -n 88 个并行线程视机器情况调从 CSV 歌单批量下载download -f 歌单.csv -l需配合-sc csv使用下载网易云某个歌单的全部歌词download -sc netease -s 歌单ID -o 输出目录 -l歌单 ID 用;分隔多个指定歌词文件命名格式-p {Artist} - {Name}.lrc支持歌手/歌名占位符调整平台优先级/搜索深度编辑config.yaml位置在src/ZonyLrcTools.Cli/config.yaml跳过已有歌词的歌配置isSkipExistLyricFiles: true避免重复下载覆盖除了download程序还预留了search、utility、manual等子命令用--help随时可以查看每个命令的说明。新手最容易踩的坑自查清单Q1运行后提示「没有找到任何音乐文件」先确认-d指向的目录里确实有支持的格式mp3/flac/wav/m4a/ogg/opus。另外程序默认是跳过已有.lrc文件的如果你之前手动放过歌词记得在config.yaml里把isSkipExistLyricFiles设为false。Q2歌词匹配到的是同名同歌手但根本不是这一首这是搜索深度的问题。config.yaml里每个平台都有depth参数默认 10值越大搜索结果越多、匹配越准但搜索耗时也会变长。个别冷门歌可以单独调大。Q3下载出来的歌词是乱码检查config.yaml的fileEncoding配置默认是utf-8如果你的播放器对编码敏感可以改成utf-8-bom或者 GBK 系编码程序会负责做编码转换。Q4某个平台一直失败config.yaml中每个平台都有一个priority优先级改成-1可以整体禁用该平台。如果网易云总是失败多半是需要登录——用网易云平台下载时程序会弹出二维码用网易云 APP 扫码授权后就能拿到高质量歌词。Q5歌词想中英双语但显示成了两行config.yaml里isEnableTranslation控制是否下载翻译歌词isOneLine控制双语是否合并为一行isOnlyOutputTranslation可以只输出翻译。按你的播放器习惯组合这三个开关即可。三个进阶玩法玩法一给网易云歌单批量补歌词目标把云端的歌单整个搬到本地还带上歌词。步骤先拿到歌单 ID网易云歌单链接里playlist?id后面的那串数字然后运行ZonyLrcTools.Cli.exe download -sc netease -s 7224428149 -o D:\TempFiles -l首次使用网易云平台时程序会生成二维码用手机扫码登录一次之后就能正常拉取。效果歌单里所有歌曲的歌词按「歌手 - 歌名.lrc」格式落盘到-o指定的目录整个过程不需要先下载任何音频文件。玩法二用 CSV 歌单定向批量处理目标手头有一份特定清单比如活动伴奏曲目表只想处理清单里的歌。步骤按「歌名、歌手、专辑」的格式整理成 CSV然后执行ZonyLrcTools.Cli.exe download -sc csv -f 歌单.csv -l效果工具只处理清单里的歌曲适合不想动整个音乐库、只想给某批特定歌曲补歌词的场景。测试用的样例 CSV 可以在仓库的tests/ZonyLrcTools.Tests/TestData/test.csv里找到。玩法三多线程加速大库处理目标几千首的大音乐库别让程序跑一个通宵。步骤把-n线程数调到机器核心数附近ZonyLrcTools.Cli.exe download -d E:\MusicLibrary -l -n 8效果歌词下载会按并行线程拆分任务处理时间能明显缩短。注意线程数不是越大越好网络请求和磁盘写入才是瓶颈一般 4~8 就够用。让歌词自己长出来折腾完那台旧笔记本后我最大的感触是好的工具不是替你省时间而是让你彻底忘记「原来还需要这件事」。ZonyLrcToolsX 就是这样的存在——装上它配好一次以后新歌入库只需要把文件丢进文件夹、跑一遍命令歌词就自己长出来了。想深入了解它仓库里的docs/zh_CN.md有完整文档歌词下载相关的核心源码在src/ZonyLrcTools.Common/Lyrics/Providers/配置文件说明在src/ZonyLrcTools.Cli/config.yaml。下一个周末试试给你的音乐库做一次彻底的歌词大扫除吧。【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
