koby_music

一个基于 Flutter 打造的跨平台在线音乐播放器，支持多音源搜索、聚合搜索、歌词显示、播放队列、收藏与下载等功能，目前支持 Android / iOS / Web / 桌面平台。

后端来自@TuneFreeNext

在线体验

koby_music

截图

---

---

功能特性

• 多平台支持

  • 基于 Flutter 构建，支持 Android / iOS / Web / Windows / Linux / macOS（取决于你本地开启的平台）。

• 在线音乐播放

  • 支持播放队列、上一首/下一首、歌单。

• 多音源与聚合搜索

  • 支持网易云、酷我音乐、QQ 音乐等多个音源。
  • 支持 聚合搜索：一次搜索同时命中多个平台。

• 歌词与专辑封面

  • 支持歌词逐行高亮显示。
  • 支持歌曲封面图显示。

• 收藏、历史与下载

  • 收藏歌曲。
  • 播放历史记录。
  • 下载管理。

---

技术栈

• 前端框架：Flutter (Material 3)
• 状态管理：provider
• 音频播放：just_audio + audio_session + just_audio_background
• 数据来源：music-dl.sayqz.com 统一音乐 API

主要代码结构：

• lib/main.dart：应用入口，Provider 注册、主题与根页面。
• lib/api/：API 客户端（如 music_dl_client.dart）。
• lib/models/：数据模型（歌曲、歌单、歌词行等）。
• lib/providers/：状态管理（播放器、搜索、发现、歌词、收藏、历史、设置等）。
• lib/ui/：页面（首页、搜索页、播放页、歌单等）。
• lib/widgets/：通用组件（迷你播放器、图片组件、歌曲菜单等）。

---

开发计划（TODO）

欢迎通过 Issue / PR 提出建议或直接参与开发。

---