深夜整理歌单的第 3 小时我决定让歌词自己长出来一个跨平台歌词批量下载工具的真实体验【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX如果你和我一样是从 CD 时代一路囤到流媒体时代的人大概能理解这种崩溃费了三天把几百 G 的本地音乐按专辑、按歌手重新归好类准备打开播放器好好享受一番结果点开第一首歌——没有歌词。手动去网页搜索、复制、粘贴、另存为.lrc文件一首歌要两三分钟300 首歌就是 10 个小时的机械劳动。更气人的是好不容易下载到歌词编码还是乱的中文全变成乱码。直到我翻到ZonyLrcToolsX这个开源项目事情才彻底改变。简单说它是一个面向本地音乐库的歌词批量下载工具能自动扫描你的音乐文件夹从网易云、QQ 音乐、酷狗、酷我等多个歌词源批量补齐歌词还顺手解决翻译歌词、文件名乱码、NCM 加密文件解码等一系列问题。这篇文章不讲官方手册只讲我作为重度用户踩过坑之后最实用的那部分玩法。先看清楚对手手动维护歌词到底贵在哪在动手安装之前先做一道成本计算题。假设你的音乐库有 500 首歌手动方案的账目是这样的环节手动操作使用 ZonyLrcToolsX找歌词源逐首歌切换网页搜索还要甄别质量自动按优先级轮询 4 个平台下载保存复制粘贴、重命名、建.lrc文件一条命令扫描全目录批量生成编码处理遇到乱码还要手动转码自动输出 UTF-8 或指定编码双语翻译中文歌词还要另找翻译版配置项一键开启翻译歌词维护成本新增歌曲就重复劳动一次随时重跑幂等无压力一句话总结手动方案是每首歌付费一次自动化方案是一次付费终身受用。而后者要付出的费用只是下载一个工具、敲一条命令而已。拿到工具两条安装路径任你选路径 AArch 系用户的 10 秒安装如果你用的是 Arch Linux 或衍生发行版这个项目已经被打包进了 AUR体验是最顺滑的yay -S zonylrctoolsx-bin # 验证安装是否成功 ZonyLrcTools.Cli --help路径 B源码编译的折腾党路线想自己动手编译、或者想读读源码学习的可以克隆仓库后按文档构建git clone https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX仓库采用解决方案.sln组织核心代码在src/下分三个工程命令行工具Cli、桌面端Desktop和公共业务库Common结构与功能边界非常清晰适合当学习样板。第一次批量下载歌词三条命令见真章命令行是这个工具的精华所在命令模块都集中在src/ZonyLrcTools.Cli/Commands/目录下。我最常用的场景有三个全部可以复制即用。场景一整个文件夹的音乐一键补齐这是最核心、也最治愈的一条命令ZonyLrcTools.Cli download -l -d /path/to/your/music-l表示下载歌词-d指定音乐文件夹。工具会自动扫描目录下的 mp3、flac、wav、m4a、ogg、opus 等格式这些后缀可以在配置里增删然后按歌手 歌名去匹配歌词逐个生成同名.lrc文件。第一次跑完看到播放器里齐刷刷的歌词那种满足感懂的人自然懂。场景二网易云歌单整单迁移如果你在网易云音乐攒了多年的歌单想把歌词全部搬进本地音乐库不需要手动导出直接指定歌单 ID 即可ZonyLrcTools.Cli download -l -sc netease -s 歌单ID -o /path/to/output-sc参数目前支持三种扫描器local本地文件夹、netease网易云歌单、csvCSV 列表。歌单场景下输出目录-o是必填项下载结果会按你设定的命名规则落盘默认是{Artist} - {Name}.lrc。顺带一提网易云接口在部分场景下会要求扫码登录命令行会直接打印二维码手机 App 扫一下即可如下图场景三NCM 加密文件的就地解救早年在网易云下载过.ncm格式的朋友都知道这种加密文件几乎只能在自家播放器里听。ZonyLrcToolsX 还内置了解密能力一条命令批量转换整个文件夹ZonyLrcTools.Cli util -s /path/to/ncm/folderutil实用命令支持单文件或整个目录解密后的文件会保存在同目录下配合-n参数还能控制并行线程数默认 1几百个文件也压得住。进阶玩家的配置台config.yaml 里藏着全部调优手段默认配置已经很好用但真正拉开体验差距的是src/ZonyLrcTools.Cli/config.yaml这个文件。它相当于整个工具的控制台以下几个选项我强烈建议你打开看一眼1. 歌词源优先级提升命中率的关键provider: lyric: plugin: - name: NetEase # 网易云 priority: 1 # 数字越小越优先改成 -1 即禁用 - name: QQ # QQ 音乐 priority: 2 - name: KuGou # 酷狗 priority: 3 - name: KuWo # 酷我 priority: 4匹配逻辑是排队制优先从网易云找找不到自动降级到 QQ、再酷狗、再酷我直到命中为止。如果你发现某个源的歌词质量差直接调低它的优先级即可。四个 provider 的实现都挂在src/ZonyLrcTools.Common/Lyrics/Providers/目录下想研究接口如何对接的这里是最好的教材。2. 双语翻译与输出格式config: isEnableTranslation: true # 开启翻译歌词 isOneLine: true # 原文与翻译合并为一行 isOnlyOutputTranslation: false fileEncoding: utf-8 # 彻底告别乱码 isSkipExistLyricFiles: false # 已存在的歌词是否跳过日系歌曲爱好者还可以给网易云单独开启罗马音输出遇到有罗马音资源的歌曲会自动附带- name: NetEase additional: isEnableRomanOutput: true3. 代理与扫描范围networkOptions支持 HTTP 代理国内网络环境偶尔需要supportFileExtensions则允许你扩充或收窄扫描的音频格式白名单。一周使用后的真实心得用了一周有几个细节让我对这个工具好感度持续上升纯音乐自动跳过下载完成后日志会区分成功 / 跳过(纯音乐) / 失败不会傻乎乎给纯音乐强行配歌词。失败清单自动落盘下载失败的歌曲会汇总成一个带时间戳的txt文件失败原因一目了然方便二次处理。多线程可控-n参数控制并发数网络差的时候调低着急的时候调高主动权在你手里。桌面端同样可用不习惯命令行的话src/ZonyLrcTools.Desktop/Views/Pages/下有完整的图形界面页面歌词下载、专辑封面、设置三页齐备基于 Avalonia 构建跨平台体验一致。下一步从缺歌词到歌词自由如果你也受够了逐首歌手动找歌词的日子我的建议是现在就动手Arch 用户直接yay -S zonylrctoolsx-bin其他平台从 Release 页面下载对应版本先拿一个小文件夹试跑download -l -d 目录确认歌词匹配质量满意之后再研究 config.yaml 里的翻译、罗马音和歌词源优先级遇到拿不准的问题项目 README 里挂着官方 QQ 群337656932群文件里还有视频教程。本地音乐库是你的私人财富而歌词是让它活过来的那层血肉。把机械劳动交给工具把时间留给真正享受音乐的时刻——这大概是这个项目送给每个音乐收藏家最好的礼物。【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 深夜整理歌单的第 3 小时，我决定让歌词自己长出来：一个跨平台歌词批量下载工具的真实体验
深夜整理歌单的第 3 小时我决定让歌词自己长出来一个跨平台歌词批量下载工具的真实体验【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX如果你和我一样是从 CD 时代一路囤到流媒体时代的人大概能理解这种崩溃费了三天把几百 G 的本地音乐按专辑、按歌手重新归好类准备打开播放器好好享受一番结果点开第一首歌——没有歌词。手动去网页搜索、复制、粘贴、另存为.lrc文件一首歌要两三分钟300 首歌就是 10 个小时的机械劳动。更气人的是好不容易下载到歌词编码还是乱的中文全变成乱码。直到我翻到ZonyLrcToolsX这个开源项目事情才彻底改变。简单说它是一个面向本地音乐库的歌词批量下载工具能自动扫描你的音乐文件夹从网易云、QQ 音乐、酷狗、酷我等多个歌词源批量补齐歌词还顺手解决翻译歌词、文件名乱码、NCM 加密文件解码等一系列问题。这篇文章不讲官方手册只讲我作为重度用户踩过坑之后最实用的那部分玩法。先看清楚对手手动维护歌词到底贵在哪在动手安装之前先做一道成本计算题。假设你的音乐库有 500 首歌手动方案的账目是这样的环节手动操作使用 ZonyLrcToolsX找歌词源逐首歌切换网页搜索还要甄别质量自动按优先级轮询 4 个平台下载保存复制粘贴、重命名、建.lrc文件一条命令扫描全目录批量生成编码处理遇到乱码还要手动转码自动输出 UTF-8 或指定编码双语翻译中文歌词还要另找翻译版配置项一键开启翻译歌词维护成本新增歌曲就重复劳动一次随时重跑幂等无压力一句话总结手动方案是每首歌付费一次自动化方案是一次付费终身受用。而后者要付出的费用只是下载一个工具、敲一条命令而已。拿到工具两条安装路径任你选路径 AArch 系用户的 10 秒安装如果你用的是 Arch Linux 或衍生发行版这个项目已经被打包进了 AUR体验是最顺滑的yay -S zonylrctoolsx-bin # 验证安装是否成功 ZonyLrcTools.Cli --help路径 B源码编译的折腾党路线想自己动手编译、或者想读读源码学习的可以克隆仓库后按文档构建git clone https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX仓库采用解决方案.sln组织核心代码在src/下分三个工程命令行工具Cli、桌面端Desktop和公共业务库Common结构与功能边界非常清晰适合当学习样板。第一次批量下载歌词三条命令见真章命令行是这个工具的精华所在命令模块都集中在src/ZonyLrcTools.Cli/Commands/目录下。我最常用的场景有三个全部可以复制即用。场景一整个文件夹的音乐一键补齐这是最核心、也最治愈的一条命令ZonyLrcTools.Cli download -l -d /path/to/your/music-l表示下载歌词-d指定音乐文件夹。工具会自动扫描目录下的 mp3、flac、wav、m4a、ogg、opus 等格式这些后缀可以在配置里增删然后按歌手 歌名去匹配歌词逐个生成同名.lrc文件。第一次跑完看到播放器里齐刷刷的歌词那种满足感懂的人自然懂。场景二网易云歌单整单迁移如果你在网易云音乐攒了多年的歌单想把歌词全部搬进本地音乐库不需要手动导出直接指定歌单 ID 即可ZonyLrcTools.Cli download -l -sc netease -s 歌单ID -o /path/to/output-sc参数目前支持三种扫描器local本地文件夹、netease网易云歌单、csvCSV 列表。歌单场景下输出目录-o是必填项下载结果会按你设定的命名规则落盘默认是{Artist} - {Name}.lrc。顺带一提网易云接口在部分场景下会要求扫码登录命令行会直接打印二维码手机 App 扫一下即可如下图场景三NCM 加密文件的就地解救早年在网易云下载过.ncm格式的朋友都知道这种加密文件几乎只能在自家播放器里听。ZonyLrcToolsX 还内置了解密能力一条命令批量转换整个文件夹ZonyLrcTools.Cli util -s /path/to/ncm/folderutil实用命令支持单文件或整个目录解密后的文件会保存在同目录下配合-n参数还能控制并行线程数默认 1几百个文件也压得住。进阶玩家的配置台config.yaml 里藏着全部调优手段默认配置已经很好用但真正拉开体验差距的是src/ZonyLrcTools.Cli/config.yaml这个文件。它相当于整个工具的控制台以下几个选项我强烈建议你打开看一眼1. 歌词源优先级提升命中率的关键provider: lyric: plugin: - name: NetEase # 网易云 priority: 1 # 数字越小越优先改成 -1 即禁用 - name: QQ # QQ 音乐 priority: 2 - name: KuGou # 酷狗 priority: 3 - name: KuWo # 酷我 priority: 4匹配逻辑是排队制优先从网易云找找不到自动降级到 QQ、再酷狗、再酷我直到命中为止。如果你发现某个源的歌词质量差直接调低它的优先级即可。四个 provider 的实现都挂在src/ZonyLrcTools.Common/Lyrics/Providers/目录下想研究接口如何对接的这里是最好的教材。2. 双语翻译与输出格式config: isEnableTranslation: true # 开启翻译歌词 isOneLine: true # 原文与翻译合并为一行 isOnlyOutputTranslation: false fileEncoding: utf-8 # 彻底告别乱码 isSkipExistLyricFiles: false # 已存在的歌词是否跳过日系歌曲爱好者还可以给网易云单独开启罗马音输出遇到有罗马音资源的歌曲会自动附带- name: NetEase additional: isEnableRomanOutput: true3. 代理与扫描范围networkOptions支持 HTTP 代理国内网络环境偶尔需要supportFileExtensions则允许你扩充或收窄扫描的音频格式白名单。一周使用后的真实心得用了一周有几个细节让我对这个工具好感度持续上升纯音乐自动跳过下载完成后日志会区分成功 / 跳过(纯音乐) / 失败不会傻乎乎给纯音乐强行配歌词。失败清单自动落盘下载失败的歌曲会汇总成一个带时间戳的txt文件失败原因一目了然方便二次处理。多线程可控-n参数控制并发数网络差的时候调低着急的时候调高主动权在你手里。桌面端同样可用不习惯命令行的话src/ZonyLrcTools.Desktop/Views/Pages/下有完整的图形界面页面歌词下载、专辑封面、设置三页齐备基于 Avalonia 构建跨平台体验一致。下一步从缺歌词到歌词自由如果你也受够了逐首歌手动找歌词的日子我的建议是现在就动手Arch 用户直接yay -S zonylrctoolsx-bin其他平台从 Release 页面下载对应版本先拿一个小文件夹试跑download -l -d 目录确认歌词匹配质量满意之后再研究 config.yaml 里的翻译、罗马音和歌词源优先级遇到拿不准的问题项目 README 里挂着官方 QQ 群337656932群文件里还有视频教程。本地音乐库是你的私人财富而歌词是让它活过来的那层血肉。把机械劳动交给工具把时间留给真正享受音乐的时刻——这大概是这个项目送给每个音乐收藏家最好的礼物。【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考