ZonyLrcToolX 4 是一个基于 CEF 的跨平台歌词下载工具。

🚧 当前版本正在开发当中。
🚧 如果你想查看可以工作的代码，请切换到 dev 分支。

下载

工具会执行每日构建动作，请访问 Release 页面进行下载。

用法

Windows 用户请在软件目录当中，按住 Shift + 右键呼出菜单，然后选择 PowerShell/命令提示符/Windows 终端，根据下述说明执行命令即可。

macOS 和 Linux 用户请打开终端，切换到软件目录，一样执行命令即可。

子命令

下载功能

子命令为 download，可用于下载歌词数据和专辑图像，支持多个下载器进行下载。

.\ZonyLrcTools.Cli.exe download -d|dir <WAIT_SCAN_DIRECTORY> [-l|--lyric] [-a|--album] [-n|--number]



.\ZonyLrcTools.Cli.exe download -h|--help

例子

# 下载歌词

.\ZonyLrcTools.Cli.exe download -d "C:\歌曲目录" -l -n 2



# 下载专辑封面

.\ZonyLrcTools.Cli.exe download -d "C:\歌曲目录" -a -n 2

指定歌曲文件源

目前程序支持从本地目录、CSV 文件、网易云歌单获取歌曲数据，然后下载 LRC 歌词数据。

指定歌词源的参数是 -sc|--scanner，可以通过这个参数指定歌曲信息的来源。它拥有以下选值，默认情况下是 local。

-sc local # 从目录获取歌曲信息。

-sc netease # 从网易云歌单获取歌曲信息。

-sc csv # 从 CSV 文件获取歌曲信息。

从网易云歌单获取歌曲数据

完整的命令如下:

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

其中 -sc 参数用于指定歌词信息的来源是网易云歌单; -o 参数指定的是歌词文件的输出目录，请尽量使用绝对路径; -s 参数指定的的是歌单的 ID，该 ID 可以从网页版的网易云音乐获得。

例如获取地址 https://music.163.com/#/playlist?id=158010361 的歌单信息，那么歌单 ID 就应该传递 158010361。

由于网易云音乐的限制，要想获取完整的歌单信息，必须扫码登录程序，还是以最上面的为例，我需要下载歌单内的歌词数据，就必须扫码之后程序才会执行。

从 CSV 文件获取歌曲数据

应 Issue 126 的请求，增加了从 CSV 获取歌曲信息的方式。这样可以在没有原始歌曲的情况下载歌词数据。

示例命令:

.\ZonyLrcTools.Cli.exe download -sc csv -o "D:\TempFiles" -f "D:\TempFiles\demo.csv" -l

其中 -f 参数用于指定 csv 文件的路径，csv 文件的格式应该如下所示，保证第一行是列信息，一共要包含两列。

Song,Artist

刀马旦,李玟

发如雪,周杰伦

说书人,寅子

爱的供养,张国荣

七里香,周杰伦

加密格式转换

子命令为 util，可用于转换部分加密歌曲，仅供个人研究学习使用，思路与源码都来自于网络。

具体支持的格式请参考项目 MusicDecrypto，本工具仅做一个集成，替换掉原本自己的一些实现。现在不需要指定对应的类型参数，程序会自动根据文件后缀选择适合的解密算法。

命令只需要一个参数 -s，指定需要转换的文件夹或者是文件路径。

.\ZonyLrcTools.Cli.exe util -s D:\CloudMusic

配置文件

程序的所有的配置信息，都在 config.yaml 进行更改，下面标注了各个配置的说明。

其中是否开启的可选项为 true 或者 false，等同于中文的是和否。

globalOption:

  # 允许扫描的歌曲文件后缀名。

  supportFileExtensions:

    - '*.mp3'

    - '*.flac'

    - '*.wav'

  # 网络代理服务设置，仅支持 HTTP 代理。

  networkOptions:

    isEnable: false # 是否启用代理。

    ip: 127.0.0.1   # 代理服务 IP 地址。

    port: 4780      # 代理服务端口号。

    updateUrl: https://api.myzony.com/lrc-tools/update # 更新检查地址。

  

  # 下载器的相关参数配置。

  provider:

    # 标签扫描器的相关参数配置。

    tag:

      # 支持的标签扫描器。

      plugin:

        - name: Taglib    # 基于 Taglib 库的标签扫描器。

          priority: 1     # 优先级，升序排列。

        - name: FileName  # 基于文件名的标签扫描器。

          priority: 2

          # 基于文件名扫描器的扩展参数。

          extensions:

            # 正则表达式，用于匹配文件名中的作者信息和歌曲信息，可根据

            # 自己的需求进行调整。

            regularExpressions: "(?'artist'.+)\\s-\\s(?'name'.+)"

      # 歌曲标签屏蔽字典替换功能。

      blockWord:

        isEnable: false             # 是否启用屏蔽字典。

        filePath: 'BlockWords.json' # 屏蔽字典的路径。

    # 歌词下载器的相关参数配置。

    lyric:

      # 支持的歌词下载器。

      plugin:

        - name: NetEase   # 基于网易云音乐的歌词下载器。

          priority: 1     # 优先级，升序排列，改为 -1 时禁用。

          depth: 10       # 搜索深度，值越大搜索结果越多，但搜索时间越长。

        - name: QQ        # 基于 QQ 音乐的歌词下载器。

          priority: 2

          # depth: 10     # 暂时不支持。

        - name: KuGou     # 基于酷狗音乐的歌词下载器。

          priority: 3

          depth: 10

        - name: KuWo      # 基于酷我音乐的歌词下载器。

          priority: 4

          depth: 10

      # 歌词下载的一些共有配置参数。

      config:

        isOneLine: true                 # 双语歌词是否合并为一行展示。

        lineBreak: "\n"                 # 换行符的类型，记得使用双引号指定。

        isEnableTranslation: true       # 是否启用翻译歌词。

        isOnlyOutputTranslation: false  # 是否只输出翻译歌词。

        isSkipExistLyricFiles: false    # 如果歌词文件已经存在，是否跳过这些文件。

        fileEncoding: 'utf-8'           # 歌词文件的编码格式。

支持的编码格式

详细信息请参考: MSDN Encoding 列表，使用 identifier and name 作为参数值填入 config.yaml 文件当中的 fileEncoding。

针对 UTF-8 BOM 格式，程序进行了特殊处理，请在 fileEncoding 里面填写 "utf-8-bom" 以支持。

支持的歌词源

歌词源	默认优先级
网易云音乐	1
QQ 音乐	2
酷狗音乐	3
酷我音乐	4

屏蔽字典

屏蔽字典适用于网易云音乐歌词下载，针对某些单词，网易云音乐使用了 * 号进行屏蔽，这个时候可以使用屏蔽字典，设置歌曲名的关键词替换。例如有一首歌曲叫做 Fucking ABC ，这个时候网易云实际的名字是 Fu**ing ，用户只需要在屏蔽字典加入替换逻辑即可，例如:

{

    "Fuckking": "Fu****ing"

}

屏蔽字典默认路径为程序所在目录的 BlockWords.json 文件，用户可以在 appsettings.json 文件中配置其他路径。

ZonyLrcToolsX歌词下载工具

下载

用法

子命令