MCPcopy Index your code
hub / github.com/amll-dev/amll-ttml-db

github.com/amll-dev/amll-ttml-db @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
78 symbols 154 edges 6 files 11 documented · 14%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

AMLL TTML DataBase

这里是 Apple Music-like Lyrics 的 TTML 逐词歌词库，为 AMLL 更佳的歌词表现提供支持。

—— AMLL 生态作品 ——

AMLL TTML DB 逐词歌词仓库

AMLL TTML Tool 逐词歌词编辑器 / AMLL Editor 下一代逐词歌词编辑器

AMLL Player 本地播放器 / AMLL Page 网页播放器

引用了 AMLL 的项目汇总

—— 本仓库中的重要文档 ——

审核细则 / TTML文件规范 / 审核团成员可审核语言

[!CAUTION]

⚠️【紧急公告】

由于未知原因，QQ 群被封了，所以我们创建了一个新的群聊，现在你可以通过 678038548 找到我们的新群聊。

由此带来的不便，还请多多谅解。

[!TIP]

📣【公告】

我们正在招募长期维护开发者！
更多信息请到 公告帖 查看
感谢各位投稿者对本项目的支持！

[!Warning] 致使用歌词库的开发者：
本仓库已迁移至 amll-dev 组织，仓库链接已更新为 https://github.com/amll-dev/amll-ttml-db ，请下游仓库注意更新。

歌词提交流程

[!IMPORTANT] 提交歌词前，请完整阅读有关 Wiki！

1. 检查是否重复提交

原则上，AMLL TTML DataBase 主要接受音源来自 网易云音乐 的歌词，以便其他用户使用，我们还接受音源来自 Apple Music、 QQ音乐、Spotify 的歌词，因此提交的 TTML 文件中应当至少包含以上四个平台之中一个平台的 ID。

[!Tip]

审核时，我们默认您所提交的歌词中，列出所有平台的所有 ID 对应的音频皆是相同的，或者音频之间的偏移量小于 1 ms，因此对于库中的歌词文件，我们只对文件中所包含的有效的网易云音乐平台 ID 所对应的歌曲作逐字歌词质量保证，除非您有为其它平台中所对应的歌曲制作并提交了特供版本。

[!WARNING]

由于历史原因，2024 年之前的投稿可能会出现一些不完全符合当前标准的内容，敬请谅解！如果你对这些内容有疑虑但有额外精力，可以考虑投稿进行修正，我们将优先处理！

在 AMLL TTML 歌词站中检索是否有已提交歌词 (推荐)

请访问 AMLL TTML 歌词站的搜索界面，输入您要提交歌词的歌曲名称并点击 搜索 按钮，如无任何结果，则该歌曲暂无 TTML 歌词，欢迎您的提交。

感谢 @cybaka520 建立的歌词站！

在此仓库中检索是否有已提交歌词

请参考 歌词元数据说明 获取您要提交歌词的歌曲 ID，在本仓库内搜索该 ID，如无任何文件，则该歌曲暂无 TTML 歌词，欢迎您的提交。

在 SearchInAMLLDB 中检索是否有已提交歌词 (备选)

请访问 SearchInAMLLDB，在最上方点击 更新数据库 按钮拉取数据，输入您要提交歌词的歌曲名称并点击 查询 按钮，如无任何结果，则该歌曲暂无 TTML 歌词，欢迎您的提交。

感谢 @SteamFinder 建立的检索站！

检索是否有歌词制作占位议题

若您准备提交某首歌曲的歌词，创建 「歌词制作占位」 议题则代表您接手了该歌曲的歌词提交工作，以避免他人同时提交导致撞车。

[!WARNING]

发布占位议题的投稿者，在发布议题后 7 日内提交的投稿将会被优先审核，无论这期间是否有其他人提交了相同的投稿。

如果超出了这个时间范围，我们仍然按照投稿顺序进行审核。

时间范围以 发布占位议题时系统显示的日期 及 PR被自动创建时系统显示的日期 为准。

如果你发布了占位议题并提交了投稿，我们建议在备注中引用你的议题，以减少可能的疑议。

请访问本仓库的 Issues 栏目，搜索您要提交歌词的歌曲名称，如无 Open 状态的、有「歌词制作占位」标签的 Issue，则该歌曲的歌词提交工作尚未被接手，欢迎您的提交。

您也可以访问 AMLL TTML 歌词站 检索。

2. 制作歌词

歌词要求

歌词审核细则参考 此条目 ，以下内容为简要基本要求概述。

硬性要求

  • 请勿在歌词主体里包含除歌词内容以外的信息，例如 作词、作曲、歌词制作者 等信息；

    我们推荐通过 AMLL TTML Tool 元数据功能存储此类信息。

  • 请勿留空行，善用 结束时间 以让歌词播放器自动生成间奏区域；
  • 单词时序不能有误，例如 开始时间 比 结束时间 晚；
  • 对于英文歌曲，单词之间的间隔不超过一个空格；
  • 对于修正已有歌词，请在补充说明处写明修改原因以及原 Pr；
  • 涉及政治敏感、有违人道主义的歌曲曲目不得提供歌词翻译（音译基本不限），如果为国语歌曲则不予提交歌词。

    对于可能有 NSFW 内容的歌词内容翻译，不反对表达原意，但请尽量把握尺度、点到为止，否则可能视情况推迟审核，甚至驳回歌词。

    NSFW：Not Safe For Work 的缩写，意思是某个网络内容不适合在工作场合浏览。它通常用于标记包含裸露、暴力或色情等不适合在工作环境中查看的内容。

一般性审核要求

  • 是逐词歌词，确保打轴时序差在 ±100 毫秒以内；

    我们原则上依旧接受逐句歌词。但除非特殊情况，我们更希望您能上传逐词歌词以带给听众最佳体验。

  • 充分利用 TTML 歌词特性，例如有背景人声歌词和对唱歌词；
  • 提供翻译和音译（如果有）。

    对于不使用 AMLL TTML Tool 的歌词制作者或歌词编辑器开发者，你可以在需要添加音译或翻译的行的 p 元素中加入 <span ttm:role="x-translation" xml:lang="...">...</span> 作为翻译文本或者 <span ttm:role="x-roman">...</span> 作为音译文本。

[!NOTE] 您可以使用来自 Apple Music 的 TTML 歌词文件，但一般情况下这类歌词很难做到完全精准，请您尽量避免不作修正直接提交，以防被审核员因 单词偏移值过大 而驳回。

使用 AMLL TTML Tool 制作逐词歌词

我们推荐使用 AMLL TTML Tool 制作逐词歌词，此 README 将简要介绍 AMLL TTML Tool 的使用步骤。

您也可以使用 @Linho1219 开发的 AMLL Editor 制作逐词歌词，此编辑器在打轴界面引入了 随播放自动滚动 ，以及更多实用功能。

您需要准备：

  1. 可被 AMLL TTML Tool 读取的歌曲音频文件；

    受加密保护的格式不受支持。

  2. 可被 AMLL TTML Tool 识别的歌词文件或歌词纯文本。

    AMLL TTML Tool 所支持的歌词格式： TTML / LRC / ESLyric / YRC / QRC / Lyricify Syllable

然后：

  1. 在左上角依次点击 文件 导入歌词 并选择您导入歌词的格式，根据页面提示导入歌词；
  2. 在左下角导入您的歌曲音频文件，调整播放倍速和音量；
  3. 在左上角依次点击 编辑 编辑歌词元数据 ，参考 歌词元数据说明 编辑歌词元数据；
  4. 在 编辑 界面编辑您的歌词，如对歌词行分词 、更改歌词行属性、填写翻译和音译歌词等；
  5. 在 打轴 界面制作逐词歌词，播放音频，善用以下按键开始打轴： | 按键 | 说明 | | ------------ | ------------------------------------------------------------ | | F | 记录 当前播放进度 为当前单词的 起始时间 。 | | G | 记录 当前播放进度 为当前单词的 结束时间 ，同时移动到下一个单词，并记录 当前播放进度 为该单词的 起始时间 。 | | H | 记录 当前播放进度 为当前单词的 结束时间 ，然后移动到下一个单词。

通常用于结束当前句子的单词，空出间奏区域，或是呈现歌手停顿式的演唱方式。 | 6. 完成打轴后，在 预览 界面预览您制作的逐词歌词； 7. 预览无误后，在左上角依次点击 文件 保存 TTML 歌词文件 保存 TTML 歌词文件。

3. 提交歌词

  • 我们推荐通过 创建「提交/补正歌词」Issue 的方式提交歌词，您可以在该页面查看详细的提交流程；

  • 您也可以通过手动提交 Pull Request 来提交歌词，这需要您确保您的 TTML 歌词文件 格式正确，并仿照本仓库内 Bot 所提交的 Pull Request 进行编写；

    此方法可以避免 Bot 在歌词提交时进行的 重排元数据 依据时间轴重排歌词行顺序 等格式化行为，但请您务必确保所提交的 TTML 歌词文件 及 Pull Request 格式完全正确。

  • 您还可以在 AMLL TTML 歌词站的 创作中心 提交歌词。在歌词站上传歌词需要您注册并登录，点击 投稿 并上传 TTML 歌词文件，通常情况下网站会自动识别歌词元数据并填充投稿标题，直接提交即可。

    目前歌词站的审核人员较少，若您想要快速审核，请优先考虑在 GitHub 提交歌词。

如果您的歌曲在网易云音乐无可用版本，您可以自行上传歌曲文件。 - 在 Issue 中，您可以在 备注 处填写歌曲文件下载链接； - 在 Pull Request 中，您可以在 Body 中的 备注 / Comment 处填写歌曲文件下载链接； - 在 AMLL TTML 歌词站 创作中心 中，您可以点击 内容管理，找到并点击进入您想要上传歌曲文件的歌词，再点击 上传音频 即可上传歌曲文件。

4. 等待审核

为了提高歌词库的歌词统一性和综合质量，您的歌词将由 AMLL TTML 歌词审核团进行人工审核，以确保您的歌词符合 歌词审核细则 的要求。

如果您的歌词提交被驳回，请依照审核员的修改意见修改歌词，然后尝试再次提交，以下是常见的驳回原因：

  • 单词时间错误，或偏移值过大；
  • 矫枉过正：
  • 在不适用于部分效果的情况下，强行加入效果；
  • 为触发某些歌词效果，刻意错误打轴。
  • 歌词行属性错误：
  • 未正确区分当前歌手处于辅助主唱，或是独自对唱演唱的状态，以至于错误设置了背景歌词和对唱歌词；
  • 除非歌词本身不为歌曲考虑使用对唱歌词，否则应该要根据当前演唱者主次关系设置正确的对唱歌词，在没有确切动机的情况下，不应将同一演唱者的同一演唱形式，设置出两种不同的歌词状态。 > 演唱形式 可以是主唱、说唱、和声等。

如果您认为您的歌词不存在审核员修改意见中的问题，请尝试再次提交并附上原因，以便审核员理解你的意图，或是请求其他审核员审核。

[!TIP] 以下所有操作，您无需输入括号 {}。

若您的歌词 Pull Request 处于 未审核（无 审核中 标签）或 审核未通过（审核留言歌词驳回原因，且标记 待更新 标签）状态，您可在该 PR 内 Comment（即评论） /update {TTML 歌词文件下载直链} 以更新歌词文件，此行为视为重新提交审核；

若您需要增加备注，请评论 /update {TTML 歌词文件下载直链} {备注}。

在 Pull Request 内 Comment（即评论） /label {标签} 以添加 合适的标签；

机器人的操作可能有将近1-2分钟的延迟，机器人在准备操作时将对此评论竖大拇指示意。

您可以评论 /close {原因} 来自助关闭本次歌词提交，原因选填。

歌词库使用方式

AMLL Player

AMLL Player 是 Apple Music-like Lyrics 的本地客户端，可播放本地音乐或连接 WebSocket 服务端，在歌曲编辑界面可从 AMLL TTML DB 搜索/导入歌词。前往下载

AMLL Page

AMLL Page 是 AMLL Player 的在线网页版本，可播放本地音乐和连接 WebSocket 服务端，除插件功能外，与 Player 基本一致。前往了解

感谢 @apoint123 开发的网页版 AMLL！

AMLL DroidMate

AMLL DroidMate 是 Android 端外置歌词显示器，使用 AMLL 渲染歌词。前往了解

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

感谢 @Zeehan2005 开发的AMLL DroidMate！

SPlayer

SPlayer 是 跨平台的音乐播放器，功能多样丰富。前往了解

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

感谢 @imsyy、@kazukokawagawa、@MoYingJi、@apoint123 等广大贡献者开发的SPlayer！

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

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

如果您依然希望使用网易云客户端作为您的播放器，同时能够继续使用本仓库中的歌词，那么请配合使用 amll-bncm-ws-connector 与 AMLL Player。

镜像源

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

作者镜像源 @Steve-xmh

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, @Luorix 与 @Burial0268 ！

AMLL TTML DB 镜像站 By @HelloZGY

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 自动镜像站 By @Luorix

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 镜像站 By @Burial0268

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

UniLyric [适配最多]

UniLyric 不仅是一个全能的歌词转换器，同时可以作为 AMLL Player 的歌词发送端。其工作原理则是通过监听 SMTC 获取系统当前播放曲目的曲名、歌手名以及播放进度（如果 SMTC 发送方有设置的话），因此只要你的播放器支持 SMTC 就可以使用。并且 UniLyric 集成了包含 AMLL TTML DB 在内的多方歌词源并且能够自动搜索，可以说是目前最好用的词库搜索方和 AMLL Player 歌词发送端。 前往了解

接入到其他项目

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

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

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

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

  • .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/ 文件夹，内部的文件以 [提交 UNIX 时间戳]-[提交者 Github ID]-[8 位随机 ID].ttml 命名。或者通过 metadata/ 文件夹中的 raw-lyrics-index.jsonl 进行检索，里面包含了所有歌词文件的元数据，并且从上到下按照从旧到新的顺序依次列出。

同时，在每个平台文件夹下，还有一个存有基本信息的 index.jsonl 逐行存储了该平台下所属的所有歌词基本信息，以原始歌词文件顺序排列，也列出了所有历史歌词信息。

共享协议

本仓库的外来数据部分遵循原数据提供方的共享协议共享，提交者自主编写的部分使用 CC0 1.0 共享协议 共享。

鸣谢

感谢各位对 AMLL 生态作品感兴趣的用户，也欢迎加入 AMLL 亲友团 QQ 群 678038548 参与讨论。

感谢所有为建设本仓库提供歌词的贡献者们！

贡献者头像画廊，点击可查阅

Core symbols most depended-on inside this repo

run_git_command
called by 10
scripts/lyric_checker_bot/src/git_utils.rs
post_comment
called by 7
scripts/lyric_checker_bot/src/github_api.rs
checkout_main_branch
called by 5
scripts/lyric_checker_bot/src/git_utils.rs
post_decline_comment
called by 4
scripts/lyric_checker_bot/src/github_api.rs
verify_pr_permission
called by 3
scripts/lyric_checker_bot/src/github_api.rs
process_ttml_string
called by 2
scripts/lyric_checker_bot/src/main.rs
process_issue
called by 2
scripts/lyric_checker_bot/src/main.rs
setup_test_env
called by 2
scripts/lyric_checker_bot/src/main.rs

Shape

Function 38
Method 24
Class 15
Enum 1

Languages

Rust100%

Modules by API surface

scripts/lyric_checker_bot/src/github_api.rs24 symbols
scripts/rebuild-folder/src/main.rs20 symbols
scripts/lyric_checker_bot/src/main.rs18 symbols
scripts/lyric_checker_bot/src/git_utils.rs11 symbols
scripts/lyric_checker_bot/src/validator.rs5 symbols

For agents

$ claude mcp add amll-ttml-db \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact