Skip to content

4.x Guide

Jump to bottom
jitwxs edited this page Jan 8, 2023 · 23 revisions

01 下载与安装

前往 GitHub Release 页面，自行选择版本，下载 vx.xx-green.zip 文件。

解压后，包含以下文件，请确保其位于同一文件夹内，并且不要修改和删除，否则将影响使用：

说明
MusicLyricApp.exe 程序入口，双击直接运行即可
NLog.config 程序执行过程日志记录配置，无需调整

当您正常使用后，程序所在同级目录下，可能会新增如下文件（夹）：

说明
MusicLyricAppSetting.json 程序的配置文件
Logs/ 程序执行过程日志文件，程序崩溃时可提交该文件用于问题定位

非必须功能将以依赖插件的形式提供，目的是为了减少应用的体积，当程序提示缺少依赖包时，您可根据提示下载对应依赖插件，具体插件用法参考该功能具体章节文档。

插件名 说明 最新版本
IpaDic 罗马音功能插件 由 v4.2 版本提供
Verbatim 逐字歌词功能插件 由 v5.2 版本提供

02 快速使用

  1. 确定您要搜索的歌曲网页链接或唯一标识

  2. 将网页链接或唯一标识，粘贴进输入框中

  3. 点击搜索按钮，或按下键盘 Enter 键

  4. 自行调整输出配置参数，点击保存按钮

  5. 在选定的保存路径下，查看输出文件

03 详细说明

3.1 搜索参数

3.1.1 音乐厂商

目前支持以下音乐厂商资源，如不能满足您的需求，可以点击上方的 问题反馈 进行建议。

  • 网易云音乐
  • QQ 音乐

3.1.2 搜索类型

支持以下的搜索类型，您可自行选择：

  • 歌曲
  • 专辑
  • 歌单（v5.4+ 版本支持）

3.1.3 精确搜索

当您已经明确要搜索的内容，请使用精确搜索功能，支持以下格式：

音乐厂商 输入参数 示例
网易云音乐 ID + 完整的歌曲页面链接 https://music.163.com/#/song?id=1923927650
ID + 歌曲唯一标识 1923927650
专辑 + 完整的专辑页面链接 https://music.163.com/#/album?id=142830214
专辑 + 专辑唯一标识 142830214
歌单 + 完整的歌单页面链接 hhttps://music.163.com/#/playlist?id=7299150850
歌单 + 歌单唯一标识 7299150850
QQ 音乐 ID + 完整的歌曲页面链接 https://y.qq.com/n/ryqq/songDetail/002V7Mbx16SjSl
ID + 歌曲唯一标识 002V7Mbx16SjSl
专辑 + 完整的专辑页面链接 https://y.qq.com/n/ryqq/albumDetail/001zdunG3TqpOt
专辑 + 专辑唯一标识 001zdunG3TqpOt
歌单 + 完整的歌单页面链接 https://y.qq.com/n/ryqq/playlist/3222752131
歌单 + 歌单唯一标识 3222752131

如果想要批量搜索，那么单个之间使用英文逗号 , 分割即可。

例如分别搜索：1923927650、440208476，等价于一次搜索: 1923927650,440208476。

3.1.4 模糊搜索

模糊搜索即关键词搜索，在输入框输入关键词后，点击 “模糊搜索” 按钮即可。选中期望的搜索结果（支持多选），右击下载即可。

3.1.5 扫盘搜索

输入参数还支持输入本地的文件夹路径，当输入文件夹路径时，应用将读取该文件夹下的所有文件名，并将其作为输入参数。

注意：

  • 不会递归子文件夹
  • 文件夹会被忽略
  • 文件的后缀会被忽略（如果有的话）
  • 文件的前后空格会被去除

例如目录 C:\Users\jitwxs\Downloads\music 下包括以下文件：

│  344157 .txt
│  344157.txt
│  1963423017
│  
└─Sub Dir
       1334296072.mp3

程序读取结果为：

344157,1963423017

3.2 歌词格式

程序目前支持以下模式的歌词组织方式，您可自行选择。以歌曲 https://music.163.com/#/song?id=440208476 举例：

1、仅显示原文

[by:刺客辣条之法与鲨]
[00:00.00] 作曲 : Olly Murs/Ina Wroldsen/Clarence Coffee Jr./Steve Robson
[00:00.10] 作词 : Olly Murs/Ina Wroldsen/Clarence Coffee Jr./Steve Robson
[00:00.30]There's a girl but I let her get away
[00:05.40]It's all my fault cause pride got in the way
[00:11.40]And I'd be lying if I said I was ok
[00:16.00]About that girl the one I let get away
...

2、仅显示译文：

[by:Nighingale_In_Nirvana]
[00:00.30]曾经心爱的女孩 我却让她擦肩而过
[00:05.40]自尊心作祟 一切都是我的错
[00:11.40]若说无事 其实只是谎言未戳破
[00:16.00]那个女孩 我们曾擦肩而过
...

3、优先原文（交错）：

[by:刺客辣条之法与鲨]
[by:Nighingale_In_Nirvana]
[00:00.00] 作曲 : Olly Murs/Ina Wroldsen/Clarence Coffee Jr./Steve Robson
[00:00.10] 作词 : Olly Murs/Ina Wroldsen/Clarence Coffee Jr./Steve Robson
[00:00.30]There's a girl but I let her get away
[00:00.30]曾经心爱的女孩 我却让她擦肩而过
[00:05.40]It's all my fault cause pride got in the way
[00:05.40]自尊心作祟 一切都是我的错
...

4、优先译文（交错）：

[by:刺客辣条之法与鲨]
[by:Nighingale_In_Nirvana]
[00:00.00] 作曲 : Olly Murs/Ina Wroldsen/Clarence Coffee Jr./Steve Robson
[00:00.10] 作词 : Olly Murs/Ina Wroldsen/Clarence Coffee Jr./Steve Robson
[00:00.30]曾经心爱的女孩 我却让她擦肩而过
[00:00.30]There's a girl but I let her get away
[00:05.40]自尊心作祟 一切都是我的错
[00:05.40]It's all my fault cause pride got in the way
...

5、独立显示：

包含 优先原文（独立） 和 优先译文（独立） 两种，在该模式下，一种歌词输出完毕后，才会输出另一种歌词。

6、合并显示：

您可自定义 歌词合并符，以使用空格合并为例：

[by:刺客辣条之法与鲨]
[by:Nighingale_In_Nirvana]
[00:00.00] 作曲 : Olly Murs/Ina Wroldsen/Clarence Coffee Jr./Steve Robson
[00:00.10] 作词 : Olly Murs/Ina Wroldsen/Clarence Coffee Jr./Steve Robson
[00:00.30]There's a girl but I let her get away 曾经心爱的女孩 我却让她擦肩而过
[00:05.40]It's all my fault cause pride got in the way 自尊心作祟 一切都是我的错
...

3.3 歌词保存

3.3.1 命名规则

支持以下文件的命名：

  • 歌曲名 - 歌手
  • 歌手 - 歌曲名
  • 歌曲名

3.3.2 文件格式

程序支持 LRC 和 SRT 两种文件格式。

3.3.3 文件编码

支持以下文件输出编码：

  • UTF-8
  • UTF-8 BOM
  • GBK
  • GB2312
  • Unicode

请优先使用 UTF-8，其次使用 UTF-8-BOM，如果还出现乱码，可以尝试切换到其他编码。如果切换到其他编码后，问题仍没有解决。请找到一个能够正常渲染的文件，把它的文件编码通过 问题反馈 告诉我，我将会补充到软件中。

如何查看一个文件的编码？

  • 普通用户：直接使用 Windows 的记事本打开它，点击左上角的文件->另存为，在弹窗右下角的保存按钮旁边可以看到当前的文件编码。
  • 开发者：使用 Sublime Text、VS Code 等文本编辑工具查看。

04 其他

4.1 歌曲链接

在点击搜索按钮后，点击 歌曲直链 按钮可以获取到歌曲的 mp3 链接，可直接复制到浏览器中进行下载。

当查询的歌曲数量为 1 时，链接会自动保存到粘贴板中；当输入数量大于 1 时，链接会输出在输入框中。

注意：该功能并不等价于歌曲下载功能，原因是：

  • 并不是所有的歌曲，都能够获取到链接
  • 及时能获取到，它的音质仅为默认试听音质

4.2 更多设置

点击程序右上角的 更多设置 按钮即可进入，支持启用或禁用以下功能。

参数名 默认值 说明
参数记忆 不开启 开启后，程序将记录您上次关闭时最后的搜索参数配置。
自动读取剪切板 不开启 开启后，当鼠标浮入应用后，将自动读取剪切板内容到输入框中。
自动检查更新 开启 开启后，程序在每次启动时会自动检查更新。
译文显示罗马音 不开启 开启后，对于日文歌曲，将使用罗马音来作为译文展示，具体见 4.3.1 节

4.2.1 时间戳格式

默认情况下，LRC 的时间戳格式为 [mm:ss.SSS]，SRT 的时间戳格式为 HH:mm:ss,SS，您可根据需要自行调整格式，支持的占位符如下：

占位符 说明
HH 小时，采用 24 小时制，结果为 0 ~ 23
mm 分钟，结果为 0 ~ 59
ss 秒，结果为 0 ~ 59
S 毫秒，仅保留一位，结果为 0 ~ 9
SS 毫秒，仅保留两位，结果为 0 ~ 99
SSS 毫秒，结果为 0 ~ 999

当毫秒占位符为 S 或 SS 时，毫秒截位规则 配置生效，目前支持四舍五入和截位两种规则。

4.2.2 罗马音

罗马音功能需要下载额外的依赖包，请前往 Release 页面在当前版本下下载名为 IpaDic.zip 的文件，解压后连同文件夹放置在和 MusicLyricApp.exe 同级目录下即可。目录结构形如：

|   MusicLyricApp.exe
|   NLog.config
|
\---IpaDic
        AUTHORS
        char.bin
        COPYING
        matrix.bin
        sys.dic
        unk.dic

当启用罗马音功能后，您可指定罗马音的字体系和具体的转换模式。

罗马音转换模式：

默认值为 spaced

（1）normal 标准模式

いつもどおりの通り独り こんな日々もはや懲り懲り
-->
itsumodoorinotoorihitorikonnahibimohayakorigori

（2）spaced 空格分组

いつもどおりの通り独り こんな日々もはや懲り懲り
-->
itsumo doori no toori hitori konna hibi mohaya korigori

（3）okurigana 送假名

いつもどおりの通り独り こんな日々もはや懲り懲り
-->
いつもどおりの通(too)り独(hito)りこんな日々(hibi)もはや懲(ko)り懲(go)り

（4）furigana 注音假名

いつもどおりの通り独り こんな日々もはや懲り懲り
-->
<ruby>い<rp>(</rp><rt>i</rt><rp>)</rp></ruby><ruby>つ<rp>(</rp><rt>tsu</rt><rp>)</rp></ruby><ruby>も<rp>(</rp><rt>mo</rt><rp>)</rp></ruby><ruby>ど<rp>(</rp><rt>do</rt><rp>)</rp></ruby><ruby>お<rp>(</rp><rt>o</rt><rp>)</rp></ruby><ruby>り<rp>(</rp><rt>ri</rt><rp>)</rp></ruby><ruby>の<rp>(</rp><rt>no</rt><rp>)</rp></ruby><ruby>通<rp>(</rp><rt>too</rt><rp>)</rp></ruby><ruby>り<rp>(</rp><rt>ri</rt><rp>)</rp></ruby><ruby>独<rp>(</rp><rt>hito</rt><rp>)</rp></ruby><ruby>り<rp>(</rp><rt>ri</rt><rp>)</rp></ruby><ruby>こ<rp>(</rp><rt>ko</rt><rp>)</rp></ruby><ruby>ん<rp>(</rp><rt>n</rt><rp>)</rp></ruby><ruby>な<rp>(</rp><rt>na</rt><rp>)</rp></ruby><ruby>日々<rp>(</rp><rt>hibi</rt><rp>)</rp></ruby><ruby>も<rp>(</rp><rt>mo</rt><rp>)</rp></ruby><ruby>は<rp>(</rp><rt>ha</rt><rp>)</rp></ruby><ruby>や<rp>(</rp><rt>ya</rt><rp>)</rp></ruby><ruby>懲<rp>(</rp><rt>ko</rt><rp>)</rp></ruby><ruby>り<rp>(</rp><rt>ri</rt><rp>)</rp></ruby><ruby>懲<rp>(</rp><rt>go</rt><rp>)</rp></ruby><ruby>り<rp>(</rp><rt>ri</rt><rp>)</rp></ruby>

可以看到输出框内打印的都是 <ruby> 标签的内容，这个需要将其保存为 *.html 文件后，才能正确显示。

罗马音字体系：

默认值为 hepburn

想快速了解这些罗马字体系的不同，可参考这个实用的网页。

4.2.3 译文缺省规则

每一句原文歌词不一定存在相对应的译文歌词，这种情况下称之为译文缺省。目前系统支持以下三种的缺省规则：

忽略展示（默认项）：

[03:01.006]I wanna know

展示空行：

[03:01.006]I wanna know
[03:01.006]

填充原文：

[03:01.006]I wanna know
[03:01.006]I wanna know

4.2.4 译文匹配精度

以歌曲 https://y.qq.com/n/ryqq/songDetail/000zhc0u0JlLFm 为例，在 01:12.780 有一句原文，但是对应的译文时间在 01:12.770。

[01:12.770]包括我在说的东西
[01:12.780](Issue) 내가 말하는 것까지 Babe

默认情况下，程序仅会将时间戳完全相同的原文和译文歌词设置为一组。为了解决这种情况，增加了 译文匹配精度 功能，默认为 0ms，即完全匹配。

当配置为 10ms 时，上面的例子就会被认为是匹配的，最终的渲染效果如下。

[01:12.780](Issue) 내가 말하는 것까지 Babe
[01:12.780]包括我在说的东西

4.2.5 逐字歌词模式

自 v5.2 版本开始提供，目前仅支持 QQ 音乐模式。

原始歌词：

[00:01.140]滅びてゆくこのステラ
[00:03.560]絆を辿るストーリー

启用逐字歌词后：

[00:01.142]滅[00:01.142]び[00:01.462]て[00:01.612]ゆ[00:01.768]く[00:02.050]こ[00:02.260]の[00:02.432]ス[00:02.581]テ[00:02.785]ラ[00:02.942]
[00:03.565]絆[00:03.565]を[00:04.213]辿[00:04.334]る[00:04.667]ス[00:04.867]ト[00:05.045]ー[00:05.284]リ[00:05.523]ー[00:05.865]

4.3 Cookie 设置

对于需要登陆的功能，如果需要正常使用，需要您在设置中提供 Cookie。如您未提供或 Cookie 失效，程序将会返回 “该搜索请求需要登陆，请填写 Cookie 后重试” 提示。

重要提示： Cookie 将会用于音乐服务商对您的身份识别，泄露 Cookie 等同于泄露了您的账号密码。如您介意或不信任本程序是否会妥善处置您的 Cookie，您有权力不提供。如您选择提供，本应用不对您账号权限的泄露承担任何风险。

本程序目前需要使用 Cookie 的功能包括：

音乐提供商 功能 启用版本
网易云音乐 “我喜欢的音乐”在内的任何未公开的歌单下载 v5.6

4.3.1 获取 Cookie

网页端完成网易云音乐或者QQ音乐的登录后，在该网站的任意页面下：

（1）鼠标右击选择 Inspect 或 检查，或者按下 F12 按键，此时浏览器会弹出一个框。

（2）在弹框中选择 Network 或 网络 选项卡，在该选项卡下选择 Fetch/XHR 子选项卡。

（3）刷新页面，可以看到接收到了许多的网络请求，打开任一一个网络请求，在 Headers 中找到一项为 cookie，将对应的数值保存下来即可。

参考文档：https://blog.csdn.net/lzsm_/article/details/126088857

05 快捷键

当您熟练使用后，利用快捷键可以让您的操作事半功倍。

功能 快捷键
精确搜索 Enter
模糊搜索 Ctrl + Enter
保存 Ctrl + S

使用问题和建议请在 Issue 沟通，定制开发请联系 jitwxs@foxmail.com

Content

Clone this wiki locally