MCPcopy Index your code
hub / github.com/amll-dev/applemusic-like-lyrics

github.com/amll-dev/applemusic-like-lyrics @v3.1.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v3.1.0 ↗ · + Follow
938 symbols 1,844 edges 163 files 58 documented · 6% updated 42d agomain-player-dev · 2026-03-27★ 2,02817 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Apple Music-like Lyrics

一个基于 Web 技术制作的类 Apple Music 歌词显示组件库,同时支持 DOM 原生React Vue 绑定,与各种平台兼容的外置播放器也仍在制作当中。

这是你能在前端系里能见到的最像 iPad Apple Music 的播放页面了。

—— AMLL 生态作品 ——

AMLL TTML DB 逐词歌词仓库 / AMLL TTML Tool 逐词歌词编辑器

AMLL 生态及源码结构

主要模块

  • AMLL-Core:AMLL 核心组件库,以 DOM 原生方式编写,提供歌词显示组件和动态流体背景组件
  • AMLL-React:AMLL React 绑定,提供 React 组件形式的歌词显示组件和动态流体背景组件
  • AMLL-Vue:AMLL Vue 绑定,提供 Vue 组件形式的歌词显示组件和动态流体背景组件
  • AMLL-Lyric:AMLL 歌词解析模块,提供对 LyRiC, YRC, QRC, Lyricify Syllable 各种歌词格式的解析和序列化支持

外部工具

  • AMLL Player:AMLL 外置播放器,提供独立的外置歌词播放器,并通过独有的 WebSocket 协议与 AMLL 任意实现了协议的程序进行通信展示歌词
  • AMLL TTML Tool: AMLL TTML 编辑器,提供对 TTML 格式歌词的编辑支持,并使用 AMLL Core 进行实时预览
  • AMLL TTML Database: AMLL TTML 数据库,提供 TTML 歌词存储仓库,以让各类歌词播放器可以使用由社区制作的 TTML 逐词歌词

歌词组件截图展示

AMLL 歌词组件展示图,歌曲: Jake Miller, HOYO-MiX - WHITE NIGHT (不眠之夜) ,TTML 歌词贡献者: @Xionghaizi001

歌曲: Jake Miller, HOYO-MiX - WHITE NIGHT (不眠之夜)

TTML 歌词贡献者: @Xionghaizi001

AMLL 歌词组件展示图,歌曲: Maroon 5 - Sugar ,TTML 歌词贡献者: @Y-CIAO

歌曲: Maroon 5 - Sugar

TTML 歌词贡献者: @Y-CIAO

AMLL 歌词组件展示图,歌曲: Taylor Swift, Brendon Urie - ME! ,TTML 歌词贡献者: @Xionghaizi001

歌曲: Taylor Swift, Brendon Urie - ME!

TTML 歌词贡献者: @Xionghaizi001

浏览器兼容性提醒

本组件框架最低要求使用以下浏览器或更新版本: - Chromuim/Edge 91+ - Firefox 100+ - Safari 9.1+

完整呈现组件所有效果需要使用以下浏览器或更新版本: - Chromuim 120+ - Firefox 100+ - Safari 15.4+

参考链接: - https://caniuse.com/mdn-css_properties_mask-image - https://caniuse.com/mdn-css_properties_mix-blend-mode_plus-lighter

性能配置参考

经过性能基准测试,五年内的主流 CPU 处理器均可以以 30FPS 正常带动歌词组件,但如果需要 60FPS 流畅运行,请确保 CPU 频率至少为 3.0Ghz 或以上。如果需要 144FPS 以上流畅运行,请确保 CPU 频率至少为 4.2Ghz 或以上。

GPU 性能在以下状况下能够以预期尺寸下满 60 帧运行: - 1080p (1920x1080): NVIDIA GTX 10 系列及以上 - 2160p (3840x2160): NVIDIA RTX 2070 及以上

代码贡献

由于作者精力有限,已经无力处理大家使用过程中产生的问题,所以关闭了 Issues 板块,但是欢迎任何对代码有积极贡献的 Pull Request!

开发/构建/打包流程

安装好 yarn, rustc, wasm-pack,克隆本仓库到任意文件夹后在终端输入以下指令即可构建:

yarn
yarn lerna run build:dev --scope "@applemusic-like-lyrics/*" # 开发构建
yarn lerna run build --scope "@applemusic-like-lyrics/*" # 发行构建

鸣谢

特别鸣谢

感谢 JetBrains 系列开发工具为 AMLL 项目提供的大力支持

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Method 440
Function 333
Class 83
Interface 67
Enum 15

Languages

TypeScript78%
Rust21%
C1%

Modules by API surface

packages/core/src/bg-render/eplor-renderer.ts60 symbols
packages/bncm/src/music-context/v3.ts45 symbols
packages/bncm/src/music-context/v2.ts42 symbols
packages/core/src/lyric-player/lyric-line.ts41 symbols
packages/bncm/src/music-context/dev.ts39 symbols
packages/core/src/lyric-player/index.ts38 symbols
packages/player/src/player-context.ts31 symbols
packages/skia-player/src/renderer/spring.rs22 symbols
packages/skia-player/src/renderer.rs22 symbols
packages/bncm/src/utils/pcm-player.ts20 symbols
packages/bncm/src/types/betterncm.d.ts19 symbols
packages/ws-protocol/src/strings.rs18 symbols

For agents

$ claude mcp add applemusic-like-lyrics \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page