薄荷音乐

薄荷音乐（MintMusic）是一个开源的安卓音乐播放器，UI 与交互参考 CeruMusic 的设计理念，使用 Flutter 从零实现。支持多平台在线音乐聚合搜索、本地音乐管理、Apple Music 风格逐字歌词（AMLL）、下载、音效增强与音

●功能特性

🎵 在线音乐 ・多音源聚合搜索：网易云 / QQ音乐 / 酷狗 / 酷我 / 咪咕 ・热门歌单、排行榜、歌单标签分类浏览 ・搜索联想与热门搜索词 ・跨音源自动换源：当前音源无法播放时自动切换其他音源继续播放 ・每音源独立音质设置（128K / 192K / 320K / FLAC 等，视音源支持而定）

📜 歌词 ・滚动歌词 + 逐字卡拉 OK（YRC / LRCX 词时间轴解析） ・AMLL（Apple Music Like Lyrics）风格逐字歌词渲染 ・双语歌词（原文 + 翻译）

🎧 播放体验 ・迷你播放器 + 全屏播放页 ・播放模式：顺序 / 列表循环 / 单曲循环 / 随机 ・倍速播放、播放进度记忆、启动时自动续播 ・音频效果：均衡器（EQ）、低音增强、・环绕音效、声道平衡 ・通知栏控制与后台播放

📂 本地与下载 ・本地音乐扫描与播放（MediaStore） ・下载管理：文件名格式 / 标签写入 / 仅 WiFi 下载

🎨 外观 ・浅色 / 深色主题，可自定义主题色 ・全屏播放页多种背景模式与动态动画

🔌 插件扩展 ・支持导入落雪（LX Music）风格的 JS 音源插件，扩展更多音源

●内置音源 - 网易云音乐 - QQ 音乐 - 酷狗音乐 - 酷我音乐 - 咪咕音乐

*内置音源通过公开接口实现，仅供学习研究。接口随时可能变更，如失效请以插件形式自行补充。

●插件系统 应用支持落雪（LX Music）风格的 JS 音源插件：

① 打开 设置 → 音源插件管理 ② 导入 JS 插件文件（需遵循 LX 插件规范） ③ 在设置中为各音源选择音质，播放时自动使用

●技术栈 ・框架：Flutter / Dart（Material 3） ・状态管理：Riverpod（flutter_riverpod + riverpod_annotation 代码生成） ・路由：go_router ・音频：just_audio + audio_service + audio_session（后台播放 / 通知栏控制） ・网络：dio ・序列化：freezed + json_serializable 歌词引擎：AMLL（@applemusic-like-lyrics，通过 amll_bridge 构建 WebView bundle） ・插件引擎：flutter_js（运行 LX 风格 JS 音源插件） ・其他：on_audio_query（本地音乐）、cached_network_image、permission_handler、record（识曲）等

⚠️环境要求 Flutter SDK 3.x（本项目使用 Dart SDK ^3.11.4） Android Studio / Android SDK

⚠️免责声明 ① 本项目仅用于个人学习与技术研究，不提供任何形式的商业服务。 ② 所有在线音乐、歌词等内容版权归原版权方所有；内置音源与插件仅为接口适配，不存储、不缓存任何音频内容。 ③ 请勿将本项目用于任何侵犯版权的用途，请支持正版音乐。 ④ 使用本项目造成的任何问题由使用者自行承担。

●界面语言：简体中文、繁体中文

🎯 开发者:github@kingmuchen

●许可证 https://github.com/kingmuchen/Mint-Music/blob/main/LICENSE