Skip to content

FrancoGiudans/Capsulyric

Repository files navigation

Capsulyric

Latest Release Downloads License

Provides status bar lyrics based on Live Update and Xiaomi SuperIsland.

Compatibility & Requirements (兼容性与要求)

Functions / 功能 Requirements / 要求 Supported Devices / 支持机型
Live Update (实况通知) Android 16+
Xiaomi HyperOS (3.0.300 required, Verified)
ColorOS, OneUI, AOSP (Community)
Xiaomi Super Island (小米超级岛) HyperOS 3.0
& Android 15+
HyperOS devices with
Root or Shizuku

Note

Systems below Android 16 or HyperOS 3.0 do not support native dynamic lyrics. 低于 Android 16 或 HyperOS 3.0 的系统不支持原生动态歌词。


Working Modes (工作模式)

1. Live Update (实况通知)

  • EN: Generally supports Android 16+. For HyperOS, version 3.0.300+ is required.
  • CN: 要求 Android 16+。针对小米设备,需要 HyperOS 3.0.300+ 版本。

2. Xiaomi Super Island (小米超级岛)

  • EN: Requires HyperOS 3.0. System requires Root access or Shizuku.
  • CN: 要求 HyperOS 3.0。系统需要 Root 权限Shizuku 环境。

Lyric Acquisition (歌词获取方式)

Method / 方式 Description / 说明
Media Notification Detects lyrics from standard notifications. / 从标准通知栏提取。
Online Lyrics Fetches from online servers. Supports translations & romanization. / 从互联网服务器获取,支持翻译与罗马音。
Superlyric API High accuracy (Root/LSPosed required). / 准确度高(需 Root/LSPosed)。
Lyric Getter Supports Meizu & LSPatch (non-root). / 支持魅族状态栏歌词及免 Root 注入。
Lyricon API Root/LSPosed required. / 需 Root/LSPosed。
Local Lyric Based on local .lrc files with auto-matching. / 基于本地 .lrc 歌词文件,支持自动匹配。

Screenshots (效果展示)

(展示机型:Xiaomi 15 | 系统版本:HyperOS 3.0.300.7 Beta | 展示应用版本:Version.26.6.2.Stable_C488)

App UI (界面风格)

Material Design   vs   MIUIX

Media Control (媒体控制弹窗)

Notification (通知形态)

Live Update (实况通知)   vs   Xiaomi Super Island (小米超级岛)

Capsule (胶囊形态)


FAQ (常见问题解答)

Q1: 如何添加解析规则? (How to add parser rules?)

CN:

  1. 开启应用设置:确认音乐应用内已开启“通知栏歌词”或“车载蓝牙歌词”。
  2. 添加解析规则:在“解析规则”页面手动添加或使用“推荐”。
  3. 配置逻辑:选择对应的“分隔符”和“顺序”并重启音乐应用。

EN:

  1. Enable App Settings: Ensure "Notification/Car Lyrics" is enabled in your music app.
  2. Add Rule: Manually add or use "Recommend" in the Parser Rules page.
  3. Configure: Select the correct "Separator" and "Order", then restart the music app.
Q2: 如何使用小米超级岛? (How to use Xiaomi Super Island?)

CN:

  • 已 Root:推荐使用 HyperCeiler 插件解除白名单限制。
  • 未 Root:授权 Shizuku 并开启“绕过小米超级岛白名单”。注意可能导致耗电增加或消息延迟。

EN:

  • Rooted: Recommended to use HyperCeiler to bypass the whitelist.
  • Non-rooted: Authorize Shizuku and enable "Bypass Xiaomi Super Island Whitelist". Note potential battery impact or message delay.
Q3: 为什么看不到歌词? (Why can't I see lyrics?)

CN:

  1. 检查权限: 确保“通知使用权”已开启。
  2. 版本要求: 需 Android 16+HyperOS 3.0.300+。低于 3.0.300 的 HyperOS 无法显示原生实况通知。
  3. App设置: 确认音乐 App 的蓝牙/通知歌词开关已打开。

EN:

  1. Permissions: Check "Notification Access".
  2. System: Requires Android 16+ or HyperOS 3.0.300+. HyperOS below 3.0.300 cannot show native live notifications.
  3. App Settings: Ensure lyrics settings are enabled in your music player.
Q4: 无法连接服务? (Cannot connect to service?)

CN: 系统回收了权限。请重新手动授予“通知使用权”。

EN: Permission revoked by system. Please re-grant "Notification Access".

Q5: 如何备份/恢复设置? (How to backup/restore settings?)

CN: 前往 设置 → 备份与恢复,支持按类别(胶囊、通知、外观、通用、解析规则、高级等)选择导出或导入。

EN: Go to Settings → Backup & Restore. Supports granular category selection (Capsule, Notifications, Appearance, General, Parser Rules, Advanced, etc.) for export/import.

Q6: 如何反馈问题? (How to submit feedback?)

CN: 请前往 GitHub Issues 提交反馈,并附带通过点击版本号唤出的 Log Console 日志。

EN: Please submit an issue at GitHub Issues with logs from the Log Console (tap version/commit to open).


Privacy (隐私说明)

This app needs to read notifications to get lyrics and playback information.

We only read media playback notification content, including: album art, artist, song title, album name, and the package name of the app currently playing media. The above information is used solely for:

  • Reading and displaying playback information
  • Extracting lyrics from media notifications
  • Matching online lyrics when Online Lyrics is enabled
  • App self-logging for diagnostics

We do NOT read chat messages, verification codes, emails, or any non-media notifications. No personal data is collected or transmitted. All processing is done locally on your device.

本应用需要读取通知以获取歌词与播放信息。

我们仅会读取媒体播放通知的内容,包括:专辑图片、歌手、歌名、专辑名,以及正在播放媒体的应用包名。 上述信息仅用于以下用途:

  • 播放信息的读取和显示
  • 媒体通知歌词的提取
  • 开启在线歌词后用以匹配在线歌词
  • 应用记录自身日志

我们不会读取您的聊天消息、验证码、邮件等非媒体类通知,也不会收集或上传您的任何个人数据。所有处理均在本地完成。


Build (构建)

git clone https://github.com/FrancoGiudans/Capsulyric.git
cd Capsulyric
./gradlew assembleDebug

License (开源协议)

Projects is licensed under GPL-3.0.

License: GPL v3


Credits (致谢)

About

提供基于Live Update和小米超级岛机制的状态栏歌词。

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages