• Lyrics on the HyperOS lock screen and AOD from multiple sources:

  • Spicy EX (Spotify, international).
  • Lyricon (popular Chinese music apps — QQ Music, NetEase Cloud Music, Kugou, etc.).
  • SuperLyric (active-line push via Binder, works with many music apps).
  • LyricInfo (injects elrc/lrc lyrics into the media session metadata of supported apps).

• Line-, word- and syllable-synchronized karaoke.

• Transliteration and translation with Spicy EX Full.

• AOD clock placement and burn-in movement.

• Keep AOD active while lyrics are visible.

• Keep the lock screen awake while music is playing.

• Raise to show AOD instead of the full lock screen.

• Rooted HyperOS 3.
• LSPosed.
• At least one lyrics source:
  • Spotify with Spicy EX Lite or Full (Publish lyrics to HyperGlow enabled).
  • A Chinese music app with Lyricon active in SystemUI.
  • SuperLyric active in the system service.
  • LyricInfo active in the music app, plus notification access for HyperGlow.

APK from Releases.

1. Enable HyperGlow in LSPosed.
2. Enable your lyrics source:
   • Spotify: enable Spicy EX for Spotify in LSPosed, then enable Publish lyrics to HyperGlow in Spicy EX.
   • Chinese music apps: enable Lyricon for SystemUI in LSPosed.
   • SuperLyric: enable SuperLyric in LSPosed.
   • LyricInfo: enable LyricInfo for the music app in LSPosed, and grant HyperGlow notification access.
3. Set HyperGlow battery usage to No restrictions.

• Only tested on Redmi K80 Pro; other Xiaomi models or SystemUI versions may behave differently — submit a compatibility report from the app.
• The LSPosed module repository syncs on release edits; if a new version does not appear, edit the release body (not just the assets) to retrigger the bot.
• Experimental mode on unsupported SystemUI versions may cause rendering glitches — disable it if lyrics look wrong.

JDK 21 and an Android SDK are required. No credentials or accounts are needed — every dependency resolves from Google's Maven repository and Maven Central.

JAVA_HOME=/path/to/jdk21 ./gradlew :app:testDebugUnitTest :app:assembleDebug

That produces an installable debug APK under app/build/outputs/apk/debug/. Released builds are signed with a private key that is not in this repository, so a build from source will not share the signing lineage of the published releases: installing your own build over a release requires uninstalling first, and the LSPosed module has to be re-enabled afterwards.

Read the specs in docs/ before changing behavior — ARCHITECTURE.md for process boundaries and trust, LOCKSCREEN_AOD_BEHAVIOR_SPEC.md for lockscreen/AOD visibility, lifetime, and power rules, STYLE_GUIDE.md for conventions. They are the contract; code that contradicts them is a bug even when it works.

This repository is generated from a private working repository, so a few things are worth knowing before opening a pull request:

• Changes are limited to what exists here. A pull request that adds files outside this tree cannot be integrated as written.
• README.md, FAQ.md, and .gitignore are generated. Edits to them are lost; raise the change in an issue instead.
• Every accepted change is verified on the maintainer's device before release. Unit tests passing is necessary, not sufficient — anything touching SystemUI hooks, AOD power, or geometry needs hardware verification that cannot run in CI.
• Large or architectural changes are worth discussing in an issue first, so the design can be checked against the specs before you build it.

GPL-3.0. See NOTICE.

• 通过多种来源在 HyperOS 锁屏与 AOD 上显示歌词：

  • Spicy EX（国际版，Spotify）。
  • Lyricon（热门国内音乐软件 —— QQ音乐、网易云音乐、酷狗音乐等）。
  • SuperLyric（通过 Binder 实时推送当前歌词行，支持众多音乐软件）。
  • LyricInfo（向受支持应用的媒体会话元数据注入 elrc/lrc 歌词）。

• 支持逐行、逐词、逐音节同步的卡拉OK。

• 搭配 Spicy EX Full 支持音译与翻译。

• AOD 时钟位置与防烧屏位移。

• 歌词显示时保持 AOD 常亮。

• 播放音乐时保持锁屏常亮。

• 拿起手机显示 AOD 而非完整锁屏。

• 已 root 的 HyperOS 3。
• LSPosed。
• 至少一个歌词源：
  • Spotify + Spicy EX Lite 或 Full（需开启 将歌词发布到 HyperGlow）。
  • 国内音乐软件 + Lyricon（在 SystemUI 作用域启用）。
  • SuperLyric（在系统服务中启用）。
  • LyricInfo（在音乐软件中启用，并为 HyperGlow 授予通知使用权）。

从 Releases 下载 APK。

1. 在 LSPosed 中启用 HyperGlow。
2. 启用你的歌词源：
   • Spotify：在 LSPosed 中为 Spotify 启用 Spicy EX，然后在 Spicy EX 中开启 将歌词发布到 HyperGlow。
   • 国内音乐软件：在 LSPosed 中为 SystemUI 启用 Lyricon。
   • SuperLyric：在 LSPosed 中启用 SuperLyric。
   • LyricInfo：在 LSPosed 中为音乐软件启用 LyricInfo，并为 HyperGlow 授予通知使用权。
3. 将 HyperGlow 的电池使用设置为 无限制。

• 仅在 Redmi K80 Pro 上测试过；其他小米机型或 SystemUI 版本可能表现不同 —— 请从应用内提交兼容性报告。
• LSPosed 模块仓库在编辑 release 时同步；如果新版本未出现，编辑 release 正文（而非仅更新资产）以重新触发 bot。
• 在不受支持的 SystemUI 版本上开启实验模式可能导致渲染异常 —— 如歌词显示异常请关闭实验模式。

需要 JDK 21 与 Android SDK。无需任何凭据或账号 —— 所有依赖均从 Google 的 Maven 仓库和 Maven Central 解析。

JAVA_HOME=/path/to/jdk21 ./gradlew :app:testDebugUnitTest :app:assembleDebug

该命令会在 app/build/outputs/apk/debug/ 下生成可安装的调试 APK。正式发布版使用不在本仓库中的私钥签名，因此从源码构建不会与已发布版本共享签名链：用自己构建的版本覆盖安装正式版需要先卸载，之后还需要在 LSPosed 中重新启用模块。

在改动行为之前，请阅读 docs/ 中的规范 —— ARCHITECTURE.md 说明进程边界与信任、LOCKSCREEN_AOD_BEHAVIOR_SPEC.md 说明锁屏/AOD 的可见性、生命周期与电源规则、STYLE_GUIDE.md 说明代码约定。它们是约定；与它们相矛盾的代码即使能用也是 bug。

本仓库由私有工作仓库生成，提交 Pull Request 前有几件事值得了解：

• 改动仅限于本仓库已有的内容。新增超出本目录文件的 PR 无法按原样合并。
• README.md、FAQ.md 和 .gitignore 为自动生成，对它们的修改会被丢弃；请改为在 issue 中提出。
• 每个被接受的改动在发布前都会在维护者的设备上验证。单元测试通过是必要条件而非充分条件 —— 任何涉及 SystemUI 挂钩、AOD 电源或几何布局的改动都需要无法在 CI 中运行的硬件验证。
• 大型或架构性改动值得先在 issue 中讨论，以便在动手前对照规范检查设计方案。

GPL-3.0。参见 NOTICE。