Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ColorOS Live Lyrics Bridge

ColorOS lock-screen lyrics demo

简体中文

把更多音乐 App 的歌词送进 ColorOS / OPlus 自带的锁屏歌词页面。

它不是悬浮窗:歌词仍由系统原生界面显示,模块负责补充完整时间轴、逐字高亮、翻译和外观设置。

v3.4.1 更新了什么

  • 修复播放器翻译设置把已安装 LyricProvider 误判为“未安装”的问题;Android 11 及以上现在可正确识别全部 8 个 Provider。
  • 补全英文制作人员信息的开头清理,清理后会收紧歌词行;同时修正官方歌词列表含插入行时的行位映射,避免歌词错位或空白。
  • 网易云、QQ、Spotify 与汽水 Provider 恢复与词幕并用时的正常歌曲提交;酷狗修复同曲不同标题版本切歌串歌、暂无歌词与封面被覆盖的问题。
  • LX Music 改进进程重启后的歌词代次,并加入低频、脱敏的 LSPosed 诊断日志,便于排查少数切歌异常。
  • 请将 Bridge 与正在使用的 LyricProvider 一起更新。 Release 提供 LyricProvider-v3.4.1.zip 合集。

主要功能

  • 原生锁屏与 AOD 歌词,不额外覆盖悬浮窗口。
  • 普通逐行、逐字高亮与翻译歌词。
  • 长句自动换行或平滑浏览,兼顾中文、日文等无空格文本。
  • 四种外观预设和实时预览。
  • 可调颜色、透明度、光晕、模糊、缩放、动效、字号、字重和对齐;歌词之间与同一句内部换行的间距可以分开设置。
  • 可按播放器记住翻译开关,清理歌词开头的歌名、制作信息和版权行。
  • 歌词显示时可保持屏幕点亮,也可自定义亮屏时长。
  • 保留系统媒体卡片原本的上一首、播放/暂停和下一首操作。

使用条件

  • 已 Root,并安装支持 libxposed API 102 的 LSPosed / LSP 管理器。
  • 系统本身带有 ColorOS / OPlus 原生锁屏歌词页面。
  • 当前主要围绕 ColorOS 16 的歌词链路开发和验证。不同 OPPO、一加、真我机型及不同 SystemUI 版本可能需要单独适配。
  • 如果系统原本没有锁屏歌词页面,本模块不会新建一个悬浮歌词窗口。

播放器支持

播放器 还要安装什么 歌词能力
Salt Player Bridge 内置适配;逐字与翻译取决于播放器数据
ConePlayer / 光锥音乐 Bridge 内置适配;正式版与 Google Play 版
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 逐字、翻译

安装方法

  1. 安装 Release 中的 ColorOS-Live-Lyrics-Bridge-<版本>.apk
  2. 在 LSPosed 中启用 Bridge,并保留推荐作用域。
  3. 表格中标注 Provider 的播放器,还要安装同一 Release 中对应的 LyricProvider-*.apk
  4. 在 LSPosed 中单独启用 Provider,只勾选它对应的音乐 App。
  5. 重启手机。

LyricProvider-<版本>.zip 只是全部 Provider APK 的下载合集,不是 Recovery 刷机包。只安装自己需要的 Provider 即可。

**汽水音乐用户:**还需在 LSP 管理器中为汽水音乐开启“还原内联钩子”,并按管理器提示处理 libart.so;同时需做好 Root 隐藏。

遇到问题先检查

  • Bridge 和 Provider 是否来自同一个 Release。
  • 是否保留 Bridge 推荐作用域,并给 Provider 选中了正确的音乐 App。
  • 系统是否真的带有 OPlus 原生锁屏歌词页面。
  • 只有普通歌词、没有逐字或翻译时,通常是当前歌词源没有提供相应数据。
  • 系统或播放器大版本更新后失效,请在 Issues 中附上机型、系统、SystemUI、播放器版本和 LSPosed 日志。

下载完整 Release · 源码与详细说明 · 问题反馈


English

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.

What's new in v3.4.1

  • Fixes installed LyricProviders being incorrectly shown as unavailable in player translation settings; all eight Providers are now visible on Android 11 and later.
  • Cleans English production credits at the lyric opening and compacts the remaining rows; also fixes slot mapping when the stock lyric list has interleaved rows, preventing misplaced or blank lyrics.
  • Restores original Lyricon song delivery alongside the Bridge for NetEase, QQ Music, Spotify, and QiShui; KuGou fixes cross-track state, missing lyrics, and cover-art replacement between alternate-title releases.
  • LX Music improves lyric generations after a player-process restart and adds low-frequency, privacy-preserving LSPosed diagnostics for rare track-change failures.
  • Update the Bridge and the LyricProviders you use together. The release includes the LyricProvider-v3.4.1.zip bundle.

Highlights

  • 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.

Requirements

  • 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.

Supported players

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
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

Installation

  1. Install ColorOS-Live-Lyrics-Bridge-<version>.apk from the release.
  2. Enable the Bridge in LSPosed and keep its recommended scope.
  3. For players marked with a Provider above, install the matching LyricProvider-*.apk from the same release.
  4. Enable each Provider separately in LSPosed and select only its matching music app.
  5. 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.

Quick checks when something does not work

  • 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

Support

WeChat and Alipay support QR code

Releases

Packages

Contributors