把更多音乐 App 的歌词送进 ColorOS / OPlus 自带的锁屏歌词页面。
它不是悬浮窗：歌词仍由系统原生界面显示，模块负责补充完整时间轴、逐字高亮、翻译和外观设置。
- 设置页完成整体 UI 重构：主页与两个二级页面统一为新的卡片分区布局，包含分区图标、实时激活状态、固定底部操作栏、未保存徽标与返回确认，控件全部改用 Material 风格并自绘下拉菜单。
- 新增迷你锁屏预览：使用真实配置的字号、颜色、光晕、模糊、缩放与对齐效果，滚动时吸顶浮动；预览卡可上滑收纳为标题栏「预览」按钮，点击即可重新展开。
- 自定义颜色改为 mockup 风格面板：HEX 输入、颜色预览、HSV 取色与输入法避让；颜色面板不会再推动主页面滚动或遮挡键盘。
- 修正主歌词颜色的语义：普通行与非实时行保持低透明度白色，主歌词颜色只作用于实时行的逐字覆盖与扫光过渡，避免整行染色和过渡区白色断层。
- 修复 LX Music 歌词覆盖层闪烁与进度错位（移除与 LyricModule 锚点同步冲突的重复回调），以及汽水音乐同曲元数据更新时覆盖层重置闪烁的问题。
- 设置页与 LX / 汽水音乐修复均已通过单元测试与 Debug 构建；真机视觉验证以本次 Release 安装后的实际锁屏表现为准。
- 升级时请从同一 Release 安装
ColorOS-Live-Lyrics-Bridge-v3.7.0.apk与对应播放器的 Provider APK。
- 原生锁屏与 AOD 歌词，不额外覆盖悬浮窗口。
- 普通逐行、逐字高亮与翻译歌词。
- 长句自动换行或平滑浏览，兼顾中文、日文等无空格文本。
- 四种外观预设和实时预览。
- 可调颜色、透明度、光晕、模糊、缩放、动效、字号、字重和对齐；歌词之间与同一句内部换行的间距可以分开设置。
- 可按播放器记住翻译开关，清理歌词开头的歌名、制作信息和版权行。
- 歌词显示时可保持屏幕点亮，也可自定义亮屏时长。
- 保留系统媒体卡片原本的上一首、播放/暂停和下一首操作。
- 已 Root，并安装支持 libxposed API 102 的 LSPosed / LSP 管理器。
- 系统本身带有 ColorOS / OPlus 原生锁屏歌词页面。
- 当前主要围绕 ColorOS 16 的歌词链路开发和验证。不同 OPPO、一加、真我机型及不同 SystemUI 版本可能需要单独适配。
- 如果系统原本没有锁屏歌词页面，本模块不会新建一个悬浮歌词窗口。
| 播放器 | 还要安装什么 | 歌词能力 |
|---|---|---|
| Salt Player | 无 | Bridge 内置适配；逐字与翻译取决于播放器数据 |
| ConePlayer / 光锥音乐 | 无 | Bridge 内置适配；正式版与 Google Play 版 |
| Metrolist | LyricProvider-Metrolist |
按播放器设置的供应商顺序搜索；BetterLyrics / KuGou 支持逐字歌词，LrcLib 可回退逐行歌词；不支持翻译歌词，也不支持词幕（Lyricon） |
| QQ 音乐 | LyricProvider-QQMusic |
逐字、翻译 |
| 网易云音乐 / 荣耀版 | LyricProvider-163Music |
逐字、翻译 |
| Apple Music | LyricProvider-AppleMusic |
逐字、翻译；不输出背景人声和对唱分轨 |
| LX Music（ToSide / Walnut 版本） | LyricProvider-LXMusic |
完整时间轴歌词；播放器提供时支持翻译歌词 |
| Poweramp | LyricProvider-Poweramp |
本地内嵌歌词与可匹配的在线歌词 |
| Spotify | LyricProvider-Spotify |
目前仅原文标准歌词，不支持翻译 |
| 汽水音乐 | LyricProvider-QiShui |
逐字、翻译；需做好 Root 隐藏并完成下方设置 |
| 酷狗音乐 / 概念版 | LyricProvider-KuGou |
逐字、翻译 |
Metrolist 是适用于安卓系统的 YouTube Music 客户端。由于 Metrolist 本身没有稳定的歌词获取接口，本 Provider 采用与 Metrolist 相同的方式从第三方歌词提供商获取歌词，因此两者获取的歌词可能存在差异。
- 安装 Release 中的
ColorOS-Live-Lyrics-Bridge-<版本>.apk。 - 在 LSPosed 中启用 Bridge，并保留推荐作用域。
- 表格中标注 Provider 的播放器，还要安装同一 Release 中对应的
LyricProvider-*.apk。 - 在 LSPosed 中单独启用 Provider，只勾选它对应的音乐 App。
- 重启手机。
LyricProvider-<版本>.zip 只是全部 Provider APK 的下载合集，不是 Recovery 刷机包。只安装自己需要的 Provider 即可。
**汽水音乐用户：**还需在 LSP 管理器中为汽水音乐开启“还原内联钩子”，并按管理器提示处理 libart.so；同时需做好 Root 隐藏。
- Bridge 和 Provider 是否来自同一个 Release。
- 是否保留 Bridge 推荐作用域，并给 Provider 选中了正确的音乐 App。
- 系统是否真的带有 OPlus 原生锁屏歌词页面。
- 只有普通歌词、没有逐字或翻译时，通常是当前歌词源没有提供相应数据。
- 系统或播放器大版本更新后失效，请在 Issues 中附上机型、系统、SystemUI、播放器版本和 LSPosed 日志。
下载完整 Release · 源码与详细说明 · 问题反馈
Bring lyrics from more music apps to the native ColorOS / OPlus lock-screen lyric page.
This is not a floating overlay. The system still owns the lyric UI; the module adds full timelines, word-by-word highlighting, translations, and appearance controls.
- The settings UI has been fully redesigned: the main page and both sub-pages share new card-based sections, section icons, a live module-status row, a pinned bottom action bar, an unsaved-changes badge and confirmation dialog, Material-style controls, and a custom-drawn dropdown.
- A new mini lock-screen preview shows real configured font sizes, colors, glow, blur, scale, and alignment, sticking to the top while scrolling. The floating preview can be collapsed into a "Preview" button in the app bar by swiping up and re-expanded by tapping it.
- Custom colors use a mockup-style anchored panel with HEX input, a color preview, HSV picking, and keyboard-avoidance positioning, so the panel no longer scrolls the page or is hidden by the IME.
- Primary lyric color semantics are corrected: regular and non-active lines stay low-opacity white, and the primary color is applied only to the word-progress reveal and its feather transition on the active line.
- Fixes LX Music lyric-overlay flickering and progress mismatch caused by competing Lyricon callbacks, and QiShui Music overlay resets on same-track metadata updates.
- Settings and Provider fixes pass unit tests and Debug builds; device-level visual verification follows installation of this release.
- Install
ColorOS-Live-Lyrics-Bridge-v3.7.0.apkand the matching Provider APK from the same release when upgrading.
- Native lock-screen and AOD lyrics, without a separate overlay.
- Line-timed lyrics, word-by-word highlighting, and translations.
- Better wrapping and smooth browsing for long CJK and other no-space text.
- Four appearance presets with a live preview.
- Controls for color, opacity, glow, blur, scale, motion, text size, weight, and alignment, with separate spacing for lyric rows and wrapped lines.
- Per-player translation preferences and guided removal of leading title, credit, and copyright lines.
- Optional keep-screen-awake behavior with a custom duration.
- Preserves the stock media card's previous, play/pause, and next actions.
- Root and an LSPosed / LSP manager that supports libxposed API 102.
- A ColorOS / OPlus ROM that already provides the native lock-screen lyric page.
- Current development and testing mainly target the ColorOS 16 lyric path. Compatibility may vary between OPPO, OnePlus, and realme devices or SystemUI releases.
- The module does not create a floating lyric window on ROMs that have no native lyric page.
| Player | Additional module | Lyric support |
|---|---|---|
| Salt Player | None | Built into the Bridge; word timing and translations depend on player data |
| ConePlayer | None | Built into the Bridge; standard and Google Play packages |
| Metrolist | LyricProvider-Metrolist |
Follows the configured provider order; BetterLyrics and KuGou support word timing, with LrcLib as a line-timed fallback; translations and Lyricon integration are not supported |
| QQ Music | LyricProvider-QQMusic |
Word-timed lyrics and translations |
| NetEase Cloud Music / Honor edition | LyricProvider-163Music |
Word-timed lyrics and translations |
| Apple Music | LyricProvider-AppleMusic |
Word-timed lyrics and translations; background-vocal and duet lanes are excluded |
| LX Music (ToSide / Walnut variants) | LyricProvider-LXMusic |
Full lyric timeline and translations when supplied by the player |
| Poweramp | LyricProvider-Poweramp |
Embedded local lyrics and lyrics available through provider matching |
| Spotify | LyricProvider-Spotify |
Standard original lyrics only; no translation support yet |
| QiShui Music | LyricProvider-QiShui |
Word-timed and translated lyrics; proper root hiding and the extra step below are required |
| KuGou Music / Concept | LyricProvider-KuGou |
Word-timed lyrics and translations |
Metrolist is a YouTube Music client for Android. Because Metrolist itself does not provide a stable lyric retrieval interface, this Provider retrieves lyrics from third-party lyric providers in the same way as Metrolist. The lyrics selected by the Provider may therefore differ from those shown inside Metrolist.
- Install
ColorOS-Live-Lyrics-Bridge-<version>.apkfrom the release. - Enable the Bridge in LSPosed and keep its recommended scope.
- For players marked with a Provider above, install the matching
LyricProvider-*.apkfrom the same release. - Enable each Provider separately in LSPosed and select only its matching music app.
- Reboot the device.
LyricProvider-<version>.zip is only a bundle of all Provider APKs; it is not a Recovery-flashable package. Install only the Providers you need.
QiShui users: also enable Restore inline hooks for QiShui in the LSP manager and follow its instructions for handling libart.so; ensure root hiding is properly configured as well.
- Confirm that the Bridge and Providers came from the same release.
- Keep the Bridge's recommended scope and select the correct music app for each Provider.
- Confirm that the ROM actually has the native OPlus lock-screen lyric page.
- If line lyrics work but word timing or translations do not, the lyric source probably does not supply that data.
- After a major OS or player update, include the device, OS, SystemUI, player versions, and LSPosed logs in an issue.
Download the complete release · Source and full documentation · Report an issue
