这里是 Apple Music-like Lyrics 的 TTML 逐词歌词库，为 AMLL 更佳的歌词表现提供支持。
—— AMLL 生态作品 ——
AMLL TTML Tool 逐词歌词编辑器 / AMLL Editor 下一代逐词歌词编辑器
AMLL Player 本地播放器 / AMLL Page 网页播放器
—— 本仓库中的重要文档 ——
审核细则 / TTML文件规范 / 审核团成员可审核语言
Warning
致使用歌词库的开发者：
本仓库已迁移至 amll-dev 组织，仓库链接已更新为 https://github.com/amll-dev/amll-ttml-db ，请下游仓库注意更新。
Important
提交歌词前，请完整阅读有关 Wiki！
原则上，AMLL TTML DataBase 主要接受音源来自 网易云音乐 的歌词，以便其他用户使用，我们还接受音源来自 Apple Music、 QQ音乐、Spotify 的歌词，因此提交的 TTML 文件中应当至少包含以上四个平台之中一个平台的 ID。
Tip
审核时，我们默认您所提交的歌词中，列出所有平台的所有 ID 对应的音频皆是相同的，或者音频之间的偏移量小于 1 ms，因此对于库中的歌词文件，我们只对文件中所包含的有效的网易云音乐平台 ID 所对应的歌曲作逐字歌词质量保证，除非您有为其它平台中所对应的歌曲制作并提交了特供版本。
Warning
由于历史原因，2024 年之前的投稿可能会出现一些不完全符合当前标准的内容，敬请谅解！如果你对这些内容有疑虑但有额外精力，可以考虑投稿进行修正，我们将优先处理！
请访问 AMLL TTML 歌词站的搜索界面，输入您要提交歌词的歌曲名称并点击 搜索 按钮，如无任何结果，则该歌曲暂无 TTML 歌词，欢迎您的提交。
感谢 @cybaka520 建立的歌词站！
请参考 歌词元数据说明 获取您要提交歌词的歌曲 ID，在本仓库内搜索该 ID，如无任何文件，则该歌曲暂无 TTML 歌词，欢迎您的提交。
请访问 SearchInAMLLDB，在最上方点击 更新数据库 按钮拉取数据，输入您要提交歌词的歌曲名称并点击 查询 按钮，如无任何结果，则该歌曲暂无 TTML 歌词，欢迎您的提交。
感谢 @SteamFinder 建立的检索站！
若您准备提交某首歌曲的歌词，创建 「歌词制作占位」 议题则代表您接手了该歌曲的歌词提交工作，以避免他人同时提交导致撞车。
Warning
发布占位议题的投稿者，在发布议题后 7 日内提交的投稿将会被优先审核，无论这期间是否有其他人提交了相同的投稿。
如果超出了这个时间范围，我们仍然按照投稿顺序进行审核。
时间范围以 发布占位议题时系统显示的日期 及 PR被自动创建时系统显示的日期 为准。
如果你发布了占位议题并提交了投稿，我们建议在备注中引用你的议题，以减少可能的疑议。
请访问本仓库的 Issues 栏目，搜索您要提交歌词的歌曲名称，如无 Open 状态的、有「歌词制作占位」标签的 Issue，则该歌曲的歌词提交工作尚未被接手，欢迎您的提交。
您也可以访问 AMLL TTML 歌词站 检索。
歌词审核细则参考 此条目 ，以下内容为简要基本要求概述。
- 请勿在歌词主体里包含除歌词内容以外的信息，例如 作词、作曲、歌词制作者 等信息；
我们推荐通过 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 制作逐词歌词，此 README 将简要介绍 AMLL TTML Tool 的使用步骤。
您也可以使用 @Linho1219 开发的 AMLL Editor 制作逐词歌词，此编辑器在打轴界面引入了 随播放自动滚动 ，以及更多实用功能。
您需要准备：
- 可被 AMLL TTML Tool 读取的歌曲音频文件；
受加密保护的格式不受支持。
- 可被 AMLL TTML Tool 识别的歌词文件或歌词纯文本。
AMLL TTML Tool 所支持的歌词格式： TTML / LRC / ESLyric / YRC / QRC / Lyricify Syllable
然后：
- 在左上角依次点击 文件 导入歌词 并选择您导入歌词的格式，根据页面提示导入歌词；
- 在左下角导入您的歌曲音频文件，调整播放倍速和音量；
- 在左上角依次点击 编辑 编辑歌词元数据 ，参考 歌词元数据说明 编辑歌词元数据；
- 在 编辑 界面编辑您的歌词，如对歌词行分词 、更改歌词行属性、填写翻译和音译歌词等；
- 在 打轴 界面制作逐词歌词，播放音频，善用以下按键开始打轴：
按键 说明 F 记录 当前播放进度 为当前单词的 起始时间 。 G 记录 当前播放进度 为当前单词的 结束时间 ，同时移动到下一个单词，并记录 当前播放进度 为该单词的 起始时间 。 H 记录 当前播放进度 为当前单词的 结束时间 ，然后移动到下一个单词。
通常用于结束当前句子的单词，空出间奏区域，或是呈现歌手停顿式的演唱方式。 - 完成打轴后，在 预览 界面预览您制作的逐词歌词；
- 预览无误后，在左上角依次点击 文件 保存 TTML 歌词文件 保存 TTML 歌词文件。
-
我们推荐通过 创建「提交/补正歌词」Issue 的方式提交歌词，您可以在该页面查看详细的提交流程；
-
您也可以通过手动提交 Pull Request 来提交歌词，这需要您确保您的 TTML 歌词文件 格式正确，并仿照本仓库内 Bot 所提交的 Pull Request 进行编写；
此方法可以避免 Bot 在歌词提交时进行的
重排元数据依据时间轴重排歌词行顺序等格式化行为，但请您务必确保所提交的 TTML 歌词文件 及 Pull Request 格式完全正确。 -
您还可以在 AMLL TTML 歌词站的 创作中心 提交歌词。在歌词站上传歌词需要您注册并登录，点击 投稿 并上传 TTML 歌词文件，通常情况下网站会自动识别歌词元数据并填充投稿标题，直接提交即可。
目前歌词站的审核人员较少，若您想要快速审核，请优先考虑在 GitHub 提交歌词。
如果您的歌曲在网易云音乐无可用版本，您可以自行上传歌曲文件。
- 在 Issue 中，您可以在 备注 处填写歌曲文件下载链接；
- 在 Pull Request 中，您可以在 Body 中的
备注/ Comment 处填写歌曲文件下载链接；- 在 AMLL TTML 歌词站 创作中心 中，您可以点击 内容管理，找到并点击进入您想要上传歌曲文件的歌词，再点击 上传音频 即可上传歌曲文件。
为了提高歌词库的歌词统一性和综合质量，您的歌词将由 AMLL TTML 歌词审核团进行人工审核，以确保您的歌词符合 歌词审核细则 的要求。
如果您的歌词提交被驳回，请依照审核员的修改意见修改歌词，然后尝试再次提交，以下是常见的驳回原因：
- 单词时间错误，或偏移值过大；
- 矫枉过正：
- 在不适用于部分效果的情况下，强行加入效果；
- 为触发某些歌词效果，刻意错误打轴。
- 歌词行属性错误：
- 未正确区分当前歌手处于辅助主唱，或是独自对唱演唱的状态，以至于错误设置了背景歌词和对唱歌词；
- 除非歌词本身不为歌曲考虑使用对唱歌词，否则应该要根据当前演唱者主次关系设置正确的对唱歌词，在没有确切动机的情况下，不应将同一演唱者的同一演唱形式，设置出两种不同的歌词状态。
演唱形式 可以是主唱、说唱、和声等。
如果您认为您的歌词不存在审核员修改意见中的问题，请尝试再次提交并附上原因，以便审核员理解你的意图，或是请求其他审核员审核。
Tip
以下所有操作，您无需输入括号 {}。
若您的歌词 Pull Request 处于 未审核（无 审核中 标签）或 审核未通过（审核留言歌词驳回原因，且标记 待更新 标签）状态，您可在该 PR 内 Comment（即评论） /update {TTML 歌词文件下载直链} 以更新歌词文件，此行为视为重新提交审核；
若您需要增加备注，请评论
/update {TTML 歌词文件下载直链} {备注}。
在 Pull Request 内 Comment（即评论） /label {标签} 以添加 合适的标签；
机器人的操作可能有将近1-2分钟的延迟，机器人在准备操作时将对此评论竖大拇指示意。
您可以评论 /close {原因} 来自助关闭本次歌词提交，原因选填。
AMLL Player 是 Apple Music-like Lyrics 的本地客户端，可播放本地音乐或连接 WebSocket 服务端，在歌曲编辑界面可从 AMLL TTML DB 搜索/导入歌词。前往下载
AMLL Page 是 AMLL Player 的在线网页版本，可播放本地音乐和连接 WebSocket 服务端，除插件功能外，与 Player 基本一致。前往了解
感谢 @apoint123 开发的网页版 AMLL！
AMLL DroidMate 是 Android 端外置歌词显示器，使用 AMLL 渲染歌词。前往了解
- 在你爱用的音乐源应用上享受 AMLL 的功能，精彩体验就在口袋之中。
- 多源歌词检索（AMLL TTML DB、酷狗、网易云、QQ），找到最符合且功能最多的歌词文件。
感谢 @Zeehan2005 开发的AMLL DroidMate！
SPlayer 是 跨平台的音乐播放器，功能多样丰富。前往了解
- 支持 流媒体 / 本地音乐 播放。
- 集成 AMLL 歌词渲染，可享受与 AMLL 一致的丝滑动效。
- 对于 本地/在线 TTML歌词 皆有良好支持。
感谢 @imsyy、@kazukokawagawa、@MoYingJi、@apoint123 等广大贡献者开发的SPlayer！
Apple Music-like Lyrics for BetterNCM 已内置本仓库歌词源，无需手动配置，仅需将歌词源 AMLL TTML 逐词歌词数据库（多源聚合） 置顶即可使用。
如果您依然希望使用网易云客户端作为您的播放器，同时能够继续使用本仓库中的歌词，那么请配合使用 amll-bncm-ws-connector 与 AMLL Player。
Details
官方源出于部分原因，可能偶发无法搜索歌词、未搜索到歌词、歌词返回数据异常等问题，您可以使用以下镜像源，在插件设置 - `歌词源` - `从歌词源字符串添加` 中输入以下内容：作者镜像源 @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 ！
19cf30a0-6206-11f0-b2b3-0d580aff0f69|%E9%95%9C%E5%83%8F%E7%AB%99||ttml|https://amlldb.bikonoo.com/ncm-lyrics/[NCM_ID].ttml
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
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 不仅是一个全能的歌词转换器，同时可以作为 AMLL Player 的歌词发送端。其工作原理则是通过监听 SMTC 获取系统当前播放曲目的曲名、歌手名以及播放进度（如果 SMTC 发送方有设置的话），因此只要你的播放器支持 SMTC 就可以使用。并且 UniLyric 集成了包含 AMLL TTML DB 在内的多方歌词源并且能够自动搜索，可以说是目前最好用的词库搜索方和 AMLL Player 歌词发送端。 前往了解
Tip
虽然这并非强制，但我们希望你在使用本歌词数据库时，能够在你的项目中加入一个指向本仓库或者衍生项目的链接或说明，或是展示每个歌词文件中的歌词作者信息（均可以在元数据中读取），以便更多人发现和建设本歌词数据库，这会给予我们莫大的帮助。
如果你想要接入本歌词数据库，可以通过对应各平台的文件夹，用您对应平台的音乐 ID 来获取歌词文件。
现阶段支持以下平台的歌词索引：
- Netease Cloud Music - 网易云音乐 -
ncm-lyrics/ - QQ Music - QQ 音乐 -
qq-lyrics/ - Apple Music -
am-lyrics/ - Spotify -
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/ 文件夹，内部的文件以 [提交 UNIX 时间戳]-[提交者 Github ID]-[8 位随机 ID].ttml 命名。或者通过 metadata/ 文件夹中的 raw-lyrics-index.jsonl 进行检索，里面包含了所有歌词文件的元数据，并且从上到下按照从旧到新的顺序依次列出。
同时，在每个平台文件夹下，还有一个存有基本信息的 index.jsonl 逐行存储了该平台下所属的所有歌词基本信息，以原始歌词文件顺序排列，也列出了所有历史歌词信息。
本仓库的外来数据部分遵循原数据提供方的共享协议共享，提交者自主编写的部分使用 CC0 1.0 共享协议 共享。
感谢各位对 AMLL 生态作品感兴趣的用户，也欢迎加入 AMLL 亲友团 QQ 群 719423243 参与讨论。
感谢所有为建设本仓库提供歌词的贡献者们！
