spicamusic-fork

项目概述

柠檬音乐（SPICa Music）分支版是一款面向本地音乐播放的现代化 Android 应用，使用 Jetpack Compose 与 Media3 ExoPlayer 构建，界面简洁、运行流畅，适合在 Android 10 及以上设备上作为日常本地播放器使用。本仓库在本地能力之外集成了内置在线音源与下载能力，使本地曲库与在线音乐可以在同一播放器中管理。

把本地播放与多平台在线音源合一的 Android 音乐播放器。

主要功能

• 本地曲库：扫描媒体库或指定文件夹，按歌曲、专辑、艺术家分类管理
• 在线音源：内置在线音源，覆盖酷我、酷狗、QQ、网易、咪咕
• 在线试听下载：支持在线搜索、试听，下载时写入内嵌歌词与封面
• 音乐管理：收藏歌曲，新建、编辑、删除歌单，查看最近与最常播放
• 音效播放：10 段均衡器与响度归一化，FFT 频谱与波形显示
• 歌词与主题：在线歌词同步显示，支持亮色、暗色与动态取色

适用人群

• 以本地音乐为主、希望补充在线音源的 Android 用户
• 需要无损与多格式播放支持的发烧友
• 喜欢自行整理歌单与播放历史的用户
• 关注界面与播放体验的普通听众

快速上手

1. 从 Releases 下载适配的 APK 并安装
2. 首次启动授予存储权限，扫描本地音乐
3. 在设置中添加在线音源，即可搜索与试听在线歌曲
4. 使用指定文件夹扫描，将某个目录加入扫描白名单
5. 需要时下载歌曲，歌词与封面会一并写入

核心优势

• 一处管理：本地与在线音乐在同一界面浏览与播放，减少切换应用
• 格式兼容广：支持 FLAC、ALAC、Opus、MP3、AAC 等多种常见与无损格式
• 可自行构建：源码模块化清晰，便于二次开发与自定义音源

系统要求

项目	要求
操作系统	Android 10（API 29）及以上
支持架构	arm64-v8a
构建环境	JDK 21+、Gradle 9.6.0、Android SDK 29+

注意事项

• 部分音频格式的软解码依赖 FFmpeg，其许可条款与项目不同
• 本分支以 GPL-3.0 发布，内置在线音源参考洛雪音乐实现
• 在线音源的可用性取决于第三方接口状态