Skip to content

Home

Jump to bottom
Xionghaizi001 edited this page Feb 10, 2026 · 5 revisions

Welcome to the amll-ttml-tool wiki!

简体中文 (Simplified Chinese)

本工具是针对 Apple Music-like Lyrics 歌词页面组件而专门设计的 TTML 歌词工具！ 因为功能相对较多，所以也适合用来制作各种格式的歌词哦！ 以下是简短的使用方式，希望可以让您快速上手使用它！

Warning

本工具仍在开发当中，仍有很多缺失的功能和 BUG，请仅用作尝鲜用途，并随时保存你的歌词文件以防万一！

加载歌词

您可以通过左上角的菜单 - 文件 - 打开歌词来加载歌词哦！ 如果您的歌词不是 TTML 格式也没有关系，歌词工具支持从 纯文本/LRC/YRC/QRC/Lyricify Syllable 格式导入歌词哦！

编辑歌词

点击上方的 编辑模式 按钮即可进入编辑模式，一般默认都是编辑模式。 您可以增加新的歌词行，增加新的单词，可以对其拆分，分词，编辑哦！ 要留意的是，最后保存的格式会将任何空格都完整保留，所以要留意英文单词的空格间隙哦！ 如果需要增加翻译歌词行和音译歌词行，可以通过菜单 查看 - 显示翻译/音译歌词 选项来显示哦！ 如果需要标记歌词行的属性（是否为背景人声或对唱人声），可以右键歌词行，选择 切换所选歌词行为背景人声/切换所选歌词行为对唱人声 或者 使用编辑菜单来切换。 如果需要批量操作歌词，可以点击歌词行左侧的选择框来选中歌词行，然后使用编辑菜单的操作批量处理歌词哦！

歌词打轴

点击上方的 打轴模式 按钮即可进入打轴模式！ 在下方的音乐播放栏里加载好音乐，就可以开始播放打轴了。 如果音乐太快，也可以在音乐播放栏的右侧调节播放速度，这样手就能跟上了~ 以下是桌面版本的默认打轴按键设置：

移动打轴光标

按键 说明
按键 A 移动到上一个单词
按键 D 移动到下一个单词
按键 W 移动到上一行歌词的第一个单词
按键 S 移动到下一个单词的第一个单词

跳转播放时间

按键 说明
按键 R 移动到上一个单词，并把当前播放进度设置为这个单词的起始时间
按键 Y 移动到下一个单词，并把当前播放进度设置为这个单词的起始时间

记录时间戳（主要打轴按键）

按键 说明
按键 F 记录当前播放进度到当前单词的起始时间
按键 G 移动到下一个单词，并把当前播放进度设置为这个单词的起始时间和先前单词的结束时间
按键 H 把当前播放进度设置为当前单词的结束时间，然后移动到下一个单词（通常用于结束当前句子的歌词，空出间奏区域，或是呈现歌手停顿式的演唱方式）

音乐播放调整

按键 说明
按键 [ 将播放速度倍率减少 0.25 倍
按键 ] 将播放速度倍率增加 0.25 倍
按键 ' 设置播放速度为原速
空格 播放 / 暂停音乐

保存歌词

和加载歌词类似，您可以将歌词保存为 TTML 格式，也可以导出到其他主流歌词格式。

但是保存到其他歌词格式会丢失部分歌词信息，详情可以参考 @applemusic-like-lyrics/lyric 的 NPM 自述文档

提交歌词到 AMLL TTML DB （仅 test 分支可用）

本步骤仅使用 AMLL Player 的简体中文用户可参考操作，如果您是为了在其他软件上使用歌词而编辑歌词的话，请参考对应的软件导入使用歌词的方式来使用歌词哦！

Caution

执行下面的步骤前，请确保你知道或具备：

  1. 自行判断使用风险的能力；
  2. 自行保护敏感信息（如 Token 、密钥等）的能力和意识；
  3. 自行通过阅读代码或使用搜索引擎、AI 等辅助工具解决问题的能力；

Warning

信息安全声明及个人信息处理告知

  1. AMLL-TTML-Tool-test（下称“本程序”，指向的 URL 为 https://amll-ttml-tool-test.vercel.app/）仅供编辑、预览、发布用户的 TTML 文件，以及向具有协作者身份的用户提供审阅前述用户发布的 TTML 文件的功能使用，不提供与此功能无关的服务。

  2. 本程序不与任何除 GitHub、网易云音乐（API）、AMLL TTML 歌词站 之外的任何第三方共享或提供你的个人信息，所有鉴权及信息处理均由对应的第三方服务完成。

  3. 用户在使用本程序时可能会被要求提供身份验证信息，如 Token、手机号码及动态验证码。这些信息均由内置的 GitHub 连接功能和网易云音乐 API 模块分别向 GitHub 和网易云音乐提供，程序仅将此类身份验证信息存储于用户的浏览器 Cookie 中，开发者或维护者 不会 也 不应该 向你要求提供这些信息。

  4. 通常情况下，本程序只会发出以下几类网络连接请求：

    • GitHub：使用 登录、待更新通知（默认开启）、提交投稿 功能时发出；
    • 网易云音乐：使用 登录 功能时，因向网易云音乐服务器鉴权发出；打开待更新文件 功能时，因 自动加载音频文件 功能发出；
    • AMLL TTML 歌词站：使用 登录歌词站 功能时，因向该站点服务器发出 OAuth 请求而发出；使用 网易云音乐 的 登录 功能时，因 API 部署于同一服务器上，也可能会发出；
    • Vercel：本程序托管于 Vercel 平台，因此可能会向该平台发出使用统计信息统计 使用者人数 及 IP地址 等基本数据。

    若你在使用本程序的过程中观察到了这些来源之外的请求，请检查你的浏览器中是否安装了其他插件或脚本，看看是不是它们让你的浏览器向其他站点发出了请求。

  5. 本程序按“现状”提供，不保证现在或未来不会产生可能的 Bug，我们将尽力避免这一情况的发生，也欢迎来自用户的积极反馈。因使用本程序导致的任何数据丢失、系统损坏等后果，用户需自行承担相应责任。

  6. 用户利用本程序制作、发布的任何内容（包括但不限于歌词、元数据）均不代表开发者和维护者立场，相关法律责任由用户自行承担。

  7. 本程序中包含指向第三方站点的链接。开发者无法控制这些站点的内容或安全性，请用户自行甄别风险。

  1. 在 https://github.com/settings/tokens 页面点击左侧的 Tokens(classic)。
  2. 点击页面右上角 Generate new token -> Generate new token(classic)，在跳转的页面中输入你的 GitHub 密码。
  3. 填写并选择具体字段：
  • Note（名称）输入框：随便写
  • Expiration（过期时间） ：按需选择，可选 7/30/60/90/自定义/永不过期
  • Select scopes（选择作用范围）：
    • repo（存储库）：使用该账号身份访问其具有权限的存储库；
      • 若你对权限范围抱有疑虑，可以仅选择 public_repo（公共存储库），不影响基本功能使用。
    • read:org（读取组织内的内容）：读取组织和团队成员信息，读取组织项目信息；
    • gist：以当前账号的身份创建和读取 gist 内容。若不选此项目，你将需要自行准备一个能够指向你的歌词文件的 https 直链。
    • user：读取用户的基本身份信息，返回结果中可能包含电子邮件等额外信息；
      • 若你对权限范围抱有疑虑，可以仅选择 read:user（仅读取用户信息），不影响基本功能使用。
  1. 在页面最底部选择 Generate token 并完成相关验证。

Caution

请注意，token 内容只会展示一次，一旦关闭页面就将永远无法找回。

如果不小心关了，也不用担心。再按照上面的步骤操作一遍即可。

  1. 回到 TTML Tool，打开 编辑->首选项->连接 ，并在 GitHub PAT 输入框内粘贴刚才得到的 token，并按照页面提示完成确认步骤。
  2. 打开你要提交的歌词文件，点击 文件 -> 上传到 AMLL 歌词数据库 ，按照页面提示完成填写并稍作等待即可。

Clone this wiki locally