用 ZonyLrcToolsX 批量下载歌词：一条命令补齐整座音乐库
用 ZonyLrcToolsX 批量下载歌词一条命令补齐整座音乐库【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX你的音乐库里躺着上千首歌可每次切歌屏幕上只有歌名和封面在孤独地转圈——歌词呢没有。手动去搜索引擎一首首找再复制、改名、存成 .lrc 文件一千首歌就是一千次重复劳动。ZonyLrcToolsX 正是一款开源的歌词批量下载工具它自动读取每首歌的元数据从网易云、QQ、酷狗、酷我等多个平台匹配歌词把上面这套流程压缩成一条命令。从手动补歌词到自动全补齐一个典型场景先想象一个老用户的使用前与使用后使用前下载了一整张专辑的 FLAC兴致勃勃打开播放器发现全部没有歌词。于是开始逐首搜索、粘贴、手动命名……使用后运行一次下载命令喝杯咖啡回来每首歌旁边都躺好了同名 .lrc 文件双语、翻译、编码全都符合预期。这种转变的关键在于工具先解决了一个最容易被忽略的问题它怎么知道每首歌是什么ZonyLrcToolsX 内置了两套标签读取方案——基于 Taglib 库直接读文件内置元数据和基于文件名的正则匹配。当标签信息残缺时后者依然能从歌手 - 歌名.mp3这类命名里把信息挖出来。相关实现位于源码的src/ZonyLrcTools.Common/TagInfo/目录TaglibTagInfoProvider.cs与FileNameTagInfoProvider.cs各司其职。ZonyLrcToolsX 下载歌词的分步安装步骤Arch Linux 用户可以直接从 AUR 安装yay -S zonylrctoolsx-bin ZonyLrcTools.Cli --help其他系统从项目 Release 页面下载预编译版本即可。首次运行建议先看帮助它列出了所有可用子命令download下载歌词与专辑图、util工具类含 .ncm 解密等。安装后第一件事是把目录里的config.yaml放到程序同级目录——它是整个工具的遥控器后面会详细讲。第一次批量下载歌词一条命令的完整拆解对新手最友好的姿势是扫描本地目录ZonyLrcTools.Cli.exe download -d /your/music/folder -l-d指定音乐文件夹路径-l声明本次要下载歌词与-a下载专辑封面相互独立也可同时开启。想顺手把封面也补齐就加上-a想加速用-n指定并发线程数ZonyLrcTools.Cli.exe download -d /your/music/folder -l -a -n 4默认只开 1 个线程对千首规模曲库有点慢。参考建议4GB 内存的机器用 12 个线程8GB 用 4 个16GB 以上再上 8 个避免把整台电脑拖卡。工具默认支持mp3、flac、wav、m4a、ogg、opus等常见格式可在配置里按需增删。进阶玩法歌单、CSV 与 ncm 解密本地文件夹只是起点ZonyLrcToolsX 还内置了三种扫描器-sc参数切换默认是local。① 网易云歌单直接拉取想给整个歌单补歌词先登录网易云网页版找到歌单 IDURL 里那一串数字然后ZonyLrcTools.Cli.exe download -sc netease -s 7224428149 -o D:\Lyrics -l多个歌单用分号分隔即可。-o指定输出目录-p可自定义文件名模板默认是{Artist} - {Name}.lrc。如上图所示从网易云下载时工具会生成二维码用手机 App 扫码登录后即可获取高质量歌词——这也是它能拿到较全歌词资源的原因之一。② CSV 清单精确处理手头有一份含歌曲路径、歌名、歌手信息的 CSV用-sc csv加-f指向文件工具会按清单逐条精确匹配。③ 顺带解开 .ncm 加密文件网易云下载的 .ncm 格式有加密保护util子命令可以把它批量转为普通格式ZonyLrcTools.Cli.exe util -s /your/ncm/folder-s既可以指向单个文件也可以指向整个文件夹转换逻辑由MusicDecrypto库完成。让歌词更合心意config.yaml 的深度定制方法配置是 ZonyLrcToolsX 的灵魂。打开config.yaml你会发现一切皆可调平台优先级与顺序。按priority升序排列数值越小越优先设为-1即禁用该平台。担心某平台匹配不准把它往后排就是lyric: plugin: - name: NetEase # 优先级 1 priority: 1 - name: QQ # 优先级 2 priority: 2 - name: KuGou # 优先级 3 priority: 3 - name: KuWo # 优先级 4 priority: 4双语与编码。喜欢中英对照打开翻译希望两行并一行调整isOneLine播放器对中文编码不友好把fileEncoding改成gb2312lyric: config: isOneLine: true # 双语是否合并为一行 isEnableTranslation: true # 是否启用翻译歌词 isOnlyOutputTranslation: false isSkipExistLyricFiles: true # 已有歌词则跳过避免重复下载 fileEncoding: utf-8 # 歌词文件编码 lineBreak: \n # 换行符类型记得用双引号文件名正则。若歌曲文件命名不是歌手 - 歌名格式可以自定义正则比如把歌手 - 歌名改成你习惯的分隔符工具据此提取作者与曲名。屏蔽词字典。某些平台歌词里会夹杂脏话或不雅词汇blockWord配置配合BlockWords.json字典可以自动替换适合给小朋友听的歌单。网络代理。受限网络环境可开启 HTTP 代理在networkOptions里填 IP 和端口即可。常见问题与避坑清单下载了一半中断日志文件会记录每个文件的状态运行目录下的Logs/warnings.txt和Logs/errors.txt分别存放警告与错误排查定位非常方便。同一首歌反复下载在配置里打开isSkipExistLyricFiles已有歌词的文件直接跳过省时省流量。网络不稳导致失败工具会按平台优先级轮询一个平台失败自动切换下一个必要时开代理并降低线程数成功率会明显提升。注意使用边界按项目说明本工具仅限个人学习研究使用请勿将产物用于商业用途。开源与下一步ZonyLrcToolsX 采用模块化设计核心逻辑在src/ZonyLrcTools.Common/下按功能分目录歌词平台实现集中在src/ZonyLrcTools.Common/Lyrics/Providers/每个平台一个文件如NetEaseLyricsProvider.cs、QQLyricsProvider.cs桌面图形界面则在src/ZonyLrcTools.Desktop/。想加一个新平台实现ILyricsProvider接口再注册进配置即可社区欢迎这样的贡献。获取源码参与开发git clone https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX现在就可以去做的三件事① 下载或安装 ZonyLrcToolsX② 把你的音乐文件夹路径填进第一条download命令③ 跑通后打开config.yaml按本文建议调好平台优先级与翻译开关。半小时之内你就能拥有一座每首歌都有歌词的音乐库这大概是最有成就感的音乐整理体验了。【免费下载链接】ZonyLrcToolsXZonyLrcToolsX 是一个能够方便地下载歌词的小软件。项目地址: https://gitcode.com/gh_mirrors/zo/ZonyLrcToolsX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
