Cubic Music：Android 开源音乐播放器

项目简介

Cubic Music 是一款独立的开源 Android 音乐播放器，使用 Kotlin 编写，界面干净现代。它可以从 YouTube Music 在线串流，把歌曲和歌单下载到本地离线收听，并提供逐字卡拉 OK 歌词、Cubic Rewind 年度回顾等玩法。项目以 GPL-3.0 许可开源，运行要求 Android 6.0（API 23）或更高版本。账号连接是可选的，也不需要任何订阅。

主要功能

播放与音频

• YouTube Music 串流，支持音源自动恢复
• Spotify Canvas 与 Shazam 识曲
• 交叉淡入淡出与无缝播放
• 播放速度、音高、音量归一化、静音跳过
• 队列管理、随机播放、循环、歌曲电台、睡眠定时
• 后台、锁屏、耳机与媒体通知控制
• 可选视频模式与多种音频可视化效果

下载与曲库

• 歌曲与歌单下载，可配置播放缓存与完整离线模式
• 分别查看已下载、已缓存与校验为损坏的文件
• 本地歌曲播放与持久化歌单
• 精确播放次数与完整收听历史
• 数据库、设置、曲库与歌单导出

歌词与发现

• 同步与不同步歌词，在时间轴可用时提供逐字卡拉 OK
• 歌词源选择、翻译、音译与歌词编辑
• 个性化 For You 推荐与快捷精选
• 搜索建议、歌手页、专辑与相关音乐
• 基于真实收听记录生成 Cubic Rewind 回顾

设计与连接

• Material You 与取自封面的配色
• Standard、Liquid 等多种播放器面板
• 自动、自定义与高对比度通知配色
• 可选 YouTube Music 同步与 Discord Rich Presence
• Android Auto、Android TV、桌面小组件与应用内更新

安装与使用

1. 打开最新发布页。
2. 下载 Cubic-Music-full.apk。
3. 在 Android 设备上打开该 APK，若系统询问，允许浏览器或文件管理器安装应用。

歌单可以在应用之间迁移，支持原生 CSV、扩展原生 CSV、Spotify 导出与 Exportify 格式；Spotify 和 Exportify 歌单会按曲名与歌手匹配成可播放结果。

如果想自行编译，需要 JDK 21 与已安装对应 compile SDK 的 Android SDK：

git clone https://github.com/cybruGhost/Cubic-Music.git
cd Cubic-Music
./gradlew assembleFull

产物位于 composeApp/build/outputs/apk/full/Cubic-Music-full.apk，API key 等私有配置放在 local.properties 中，不要提交。

注意事项

• 请只从该仓库的发布页安装，第三方 APK 镜像可能分发过期或被修改的版本。
• 上游 YouTube 的变动可能在不预警的情况下影响旧版本，播放行为异常时先升级到最新版。
• 项目在本地开发，公开仓库不一定包含每一次改动。
• 桌面版 Cubic Music v3 正在另一个仓库 DESKTOP-CUBIC-MUSIC 中开发。

---

本作品整理自 GitHub 开源项目 cybruGhost/Cubic-Music，原作者 @cybruGhost，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。