Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
105 changes: 3 additions & 102 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -220,108 +220,9 @@

# 歌词库使用方式

## AMLL Player

AMLL Player 是 Apple Music-like Lyrics 的本地客户端,可播放本地音乐或连接 WebSocket 服务端,在歌曲编辑界面可从 AMLL TTML DB 搜索/导入歌词。[前往下载](https://github.com/amll-dev/applemusic-like-lyrics/actions/workflows/build-player.yaml)

## AMLL Page

AMLL Page 是 AMLL Player 的在线网页版本,可播放本地音乐和连接 WebSocket 服务端,除插件功能外,与 Player 基本一致。[前往了解](https://github.com/apoint123/amll-page)

> 感谢 [@apoint123](https://github.com/apoint123) 开发的网页版 AMLL!

## AMLL DroidMate

AMLL DroidMate 是 Android 端外置歌词显示器,使用 AMLL 渲染歌词。[前往了解](https://github.com/Zeehan2005/AMLL-DroidMate)

- 在你爱用的音乐源应用上享受 AMLL 的功能,精彩体验就在口袋之中。
- 多源歌词检索(AMLL TTML DB、酷狗、网易云、QQ),找到最符合且功能最多的歌词文件。

> 感谢 [@Zeehan2005](https://github.com/Zeehan2005) 开发的AMLL DroidMate!

## SPlayer

SPlayer 是 跨平台的音乐播放器,功能多样丰富。[前往了解](https://github.com/imsyy/SPlayer)

- 支持 **流媒体 / 本地音乐** 播放。
- 集成 AMLL 歌词渲染,可享受与 AMLL 一致的丝滑动效。
- 对于 **本地/在线** TTML歌词 皆有良好支持。

> 感谢 [@imsyy](https://github.com/imsyy)、[@kazukokawagawa](https://github.com/kazukokawagawa)、[@MoYingJi](https://github.com/MoYingJi)、[@apoint123](https://github.com/apoint123) 等广大贡献者开发的SPlayer!

## Apple Music-like Lyrics for BetterNCM [停止维护]

Apple Music-like Lyrics for BetterNCM 已内置本仓库歌词源,无需手动配置,仅需将歌词源 **AMLL TTML 逐词歌词数据库(多源聚合)** 置顶即可使用。

> 如果您依然希望使用网易云客户端作为您的播放器,同时能够继续使用本仓库中的歌词,那么请配合使用 [amll-bncm-ws-connector](https://github.com/Steve-xmh/amll-bncm-ws-connector) 与 AMLL Player。

### 镜像源

<details>
官方源出于部分原因,可能偶发无法搜索歌词、未搜索到歌词、歌词返回数据异常等问题,您可以使用以下镜像源,在插件设置 - `歌词源` - `从歌词源字符串添加` 中输入以下内容:

作者镜像源 [@Steve-xmh](https://github.com/Steve-xmh)

```text
61ba6770-f02f-11ef-a3ae-5396943709e6|AMLL%20TTML%20%E9%80%90%E8%AF%8D%E6%AD%8C%E8%AF%8D%E6%95%B0%E6%8D%AE%E5%BA%93%EF%BC%88stevexmh.net%20%E9%95%9C%E5%83%8F%EF%BC%89||ttml|https://amll-ttml-db.stevexmh.net/ncm/[NCM_ID]
```

### 社区镜像源

您也可以尝试由社区提供的镜像源,具体使用方法请自行在站内查阅,感谢 [@HelloZGY](https://github.com/cybaka520), [@Luorix](https://github.com/LuorixDev) 与 [@Burial0268](https://github.com/Burial0268) !

[AMLL TTML DB 镜像站](https://amlldb.bikonoo.com/mirror.html) By [@HelloZGY](https://github.com/cybaka520)

```text
19cf30a0-6206-11f0-b2b3-0d580aff0f69|%E9%95%9C%E5%83%8F%E7%AB%99||ttml|https://amlldb.bikonoo.com/ncm-lyrics/[NCM_ID].ttml
```

[AMLL-TTML-DB 自动镜像站](https://amll.mirror.dimeta.top/) By [@Luorix](https://github.com/LuorixDev)

```text
06e48500-d086-11f0-bb6e-451fd0fc9216|Dimeta%E9%95%9C%E5%83%8F%E7%AB%99v1||ttml|https://amll.mirror.dimeta.top/api/db/ncm-lyrics/[NCM_ID].ttml
```

[GDBA 镜像站](https://amll-ttml-db.gbclstudio.cn) By [@Burial0268](https://github.com/Burial0268)
```text
c552e13a-19a4-4ff1-9b37-f4cdeb3de9dd|GDBA%E9%95%9C%E5%83%8F%E7%AB%99||ttml|https://amll-ttml-db.gbclstudio.cn/ncm-lyrics/[NCM_ID].ttml
```
</details>

## UniLyric [适配最多]

UniLyric 不仅是一个全能的歌词转换器,同时可以作为 AMLL Player 的歌词发送端。其工作原理则是通过监听 [SMTC](https://learn.microsoft.com/en-us/windows/uwp/audio-video-camera/integrate-with-systemmediatransportcontrols) 获取系统当前播放曲目的曲名、歌手名以及播放进度(如果 SMTC 发送方有设置的话),因此只要你的播放器支持 SMTC 就可以使用。并且 UniLyric 集成了包含 AMLL TTML DB 在内的多方歌词源并且能够自动搜索,可以说是目前最好用的词库搜索方和 AMLL Player 歌词发送端。 [前往了解](https://github.com/apoint123/Unilyric)

## 接入到其他项目

> [!TIP]
虽然这并非强制,但我们希望你在使用本歌词数据库时,能够在你的项目中加入一个指向本仓库或者衍生项目的链接或说明,或是展示每个歌词文件中的歌词作者信息(均可以在元数据中读取),以便更多人发现和建设本歌词数据库,这会给予我们莫大的帮助。

如果你想要接入本歌词数据库,可以通过对应各平台的文件夹,用您对应平台的音乐 ID 来获取歌词文件。

现阶段支持以下平台的歌词索引:

- [Netease Cloud Music - 网易云音乐](./ncm-lyrics) - [`ncm-lyrics/`](https://github.com/amll-dev/amll-ttml-db/tree/main/ncm-lyrics)
- [QQ Music - QQ 音乐](./qq-lyrics) - [`qq-lyrics/`](https://github.com/amll-dev/amll-ttml-db/tree/main/qq-lyrics)
- [Apple Music](./am-lyrics) - [`am-lyrics/`](https://github.com/amll-dev/amll-ttml-db/tree/main/am-lyrics)
- [Spotify](./spotify-lyrics) - [`spotify-lyrics/`](https://github.com/amll-dev/amll-ttml-db/tree/main/spotify-lyrics)

每个歌词文件均已自动生成不同格式的歌词文件,通过文件后缀名区分:

- `.ttml` - 原 TTML 歌词格式
- `.lrc` - LyRiC 歌词格式
- `.yrc` - 网易云音乐逐词歌词格式
- `.qrc` - QQ 音乐逐词歌词格式
- `.lys` - Lyricify Syllable 逐词歌词格式
- `.eslrc` - ESLrc 逐词歌词格式

您可以通过以下直链获取您对应平台音乐 ID 的歌词文件:

> `https://raw.githubusercontent.com/amll-dev/amll-ttml-db/refs/heads/main/[对应平台歌词文件夹]/[音乐ID].[后缀名]`

如果需要检索从建立数据库开始至今所有的歌词文件,可以访问 [raw-lyrics/](./raw-lyrics/) 文件夹,内部的文件以 `[提交 UNIX 时间戳]-[提交者 Github ID]-[8 位随机 ID].ttml` 命名。或者通过 [metadata/](./metadata) 文件夹中的 [`raw-lyrics-index.jsonl`](https://github.com/amll-dev/amll-ttml-db/raw/refs/heads/main/metadata/raw-lyrics-index.jsonl) 进行检索,里面包含了所有歌词文件的元数据,并且从上到下按照从旧到新的顺序依次列出。

同时,在每个平台文件夹下,还有一个存有基本信息的 `index.jsonl` 逐行存储了该平台下所属的所有歌词基本信息,以原始歌词文件顺序排列,也列出了所有历史歌词信息。
> [!Warning]
> ## 使用方式迁移至 Wiki
> **由于内容较多,请您跳转至 [Wiki](https://github.com/amll-dev/amll-ttml-db/wiki/%E4%BD%BF%E7%94%A8%E6%AD%8C%E8%AF%8D) 查看,带来的不便敬请谅解!**

***

Expand Down