AM++

简体中文 | English

Apple Music 的 Android 增强模块：平板双栏、歌词定制与液态玻璃。

无需 LSPosed 的npatch 嵌入版也可直接安装。

项目简介
功能
效果展示
安装
使用
从源码构建
项目结构
路线图
贡献
隐私与权限
许可证与致谢

项目简介

安装后，在 Apple Music → 设置 → AM++ 模块设置 中管理功能。模块无独立启动图标。

支持导入 ZIP 插件扩展功能，详见插件开发手册。

功能

功能	默认	说明
平板双栏播放器	开启	横屏时并排显示播放控件与实时歌词。
强制显示蜂窝数据入口	关闭	在设置中显示原生蜂窝数据选项。
双向歌词模糊	开启	当前歌词保持清晰，前后歌词渐变模糊，支持调节强度（Android 12+）。
CJK 长尾歌词动画	开启	为中日韩歌词加入长音扫光动画。
歌曲名显示修正	关闭	按歌曲原地区、中国大陆或日本显示歌曲名与相关信息。
自定义歌词	关闭	导入、编辑 TTML 歌词，支持在线获取与 ZIP 备份恢复。
自动实时补全	开启	启用自定义歌词后，为缺词、非逐字或缺翻译的歌曲自动查找歌词。
歌词字体	关闭	导入 TTF/OTF 字体，随时恢复原字体。
液态玻璃底栏	关闭	为导航栏和迷你播放器加入液态玻璃效果（Android 13+）。
随滚动收缩	开启	手机端随页面滚动收缩或展开玻璃底栏，实时生效。

效果展示

自定义歌词注入

MiSans 字体替换

平板双栏播放器与歌词模糊

液态玻璃底栏

安装

Xposed 模块（推荐）

需要 Apple Music 和支持 libxposed API 102 的 Xposed 框架。

从 Releases 下载并安装 AM++ APK。
在 LSPosed 或兼容的 Xposed 管理器中启用 AM++。
作用域只勾选 Apple Music（com.apple.android.music）。
强制停止并重新打开 Apple Music。
打开 Apple Music → 设置 → “AM++ 模块设置”。

npatch 嵌入版

直接安装 npatch 嵌入版，无需 LSPosed，无法与官方版共存。

使用

部分设置需强制停止并重新打开 Apple Music 后生效。

自定义歌词

打开“自定义歌词”，启用“自定义歌词替换”。
点“获取 ID”读取当前歌曲，或手动填写 Apple Music ID。
粘贴或导入 TTML，也可从 AMLL、AM-Lyrics、Lunabeat 在线获取。
保存并启用该歌曲的歌词。
强制停止并重新打开 Apple Music。

歌词支持搜索、编辑、删除和 ZIP 备份恢复；恢复时可选择覆盖或保留已有歌词。手动编写 TTML 可参考格式说明。

歌词字体

在“歌词字体”中选择 TTF 或 OTF 文件。
导入完成后，强制停止并重新打开 Apple Music。
点“恢复原字体”并重开 Apple Music 即可还原。

字体仅应用于播放器歌词。

液态玻璃底栏

打开“液态玻璃底栏”，强制停止并重新打开 Apple Music，即可为导航栏和迷你播放器应用玻璃效果。

可调节背景模糊强度；手机端还可开启“随滚动收缩”，让底栏随页面滚动自动收起、展开。

歌曲名显示修正

打开“歌曲名显示修正”，选择地区模式后重开 Apple Music。关闭时跟随 Apple Music 账号地区。

从源码构建

环境：JDK 17、Android SDK 37、Build Tools 37.0.0，使用项目自带的 Gradle Wrapper。

Windows：

.\gradlew.bat test :app:lintDebug :app:lintVitalRelease :app:assembleRelease

Linux 或 macOS：

chmod +x gradlew
./gradlew test :app:lintDebug :app:lintVitalRelease :app:assembleRelease

生成的 Release APK 位于：

app/build/outputs/apk/release/app-release.apk

构建 Release 前，将 keystore.properties.example 复制为 keystore.properties 并填写签名信息；无需签名配置可构建 Debug APK。

项目结构

app/src/main/java/        模块入口、设置页与功能装配
app/src/main/resources/   libxposed 模块元数据
core/                     配置、歌词、网络来源与布局策略
host-api/                 宿主能力与事件接口
hook-runtime/             Xposed 封装与日志
host-applemusic/           Apple Music 版本适配
glass/                    液态玻璃渲染
backdrop/                 上游 Backdrop 库
docs/                     使用与开发文档
scripts/                  开发辅助脚本

路线图

平板横屏双栏播放器
双向歌词模糊
自定义歌词注入与备份恢复
歌词字体导入与恢复
液态玻璃底栏与迷你播放器
歌曲名显示修正
持续适配后续 Apple Music 版本

贡献

欢迎提交 Issue 和 Pull Request。代码改动请通过测试与构建；反馈界面问题时，请附设备型号、系统及 Apple Music 版本、截图或录屏。

开发与适配请参阅文档目录和宿主适配手册。

隐私与权限

仅声明 INTERNET 权限，用于歌词获取、翻译补全和歌曲信息查询。
不申请存储或通知运行时权限，本地文件通过系统文件选择器导入。
不含分析服务，也没有独立启动图标。
设置、歌词与字体保存在 Apple Music 私有目录。

许可证与致谢

本项目以 GNU General Public License v3.0 开源。第三方许可见 THIRD_PARTY_NOTICES.md。

AMLyricBlur：歌词模糊。
AndroidLiquidGlass / Backdrop：液态玻璃效果与交互。

(返回顶部)