md3Music

# MD3Music

<div align="center">

<img src="assets/images/app_icon.png" width="128" alt="MD3Music 应用图标" />

<p><strong>A modern Material 3 music player built with Flutter &amp; Rust.</strong><br />
支持 Android、Windows 与 Android TV 的 Material 3 / Apple Music 风格音乐播放器。</p>

[![Flutter](https://img.shields.io/badge/Flutter-3.47.0+-02569B?logo=flutter)](https://flutter.dev)
[![Platform](https://img.shields.io/badge/Platform-Android%20%7C%20Windows%20%7C%20TV-green)](https://github.com/zzyoxml/md3Music/releases)
[![License](https://img.shields.io/badge/License-AGPL--3.0-blue)](LICENSE)

<p>
  <a href="https://github.com/zzyoxml/md3Music/releases">下载最新版</a> ·
  <a href="#-功能特性">功能特性</a> ·
  <a href="#-快速开始">构建指南</a> ·
  <a href="MCP_GUIDE.md">AI 代理接入</a> ·
  <a href="CONTRIBUTING.md">贡献指南</a> ·
</p>

</div>

<p align="center">
  <img src="img/phone/md3/Screenshot_2026-08-31-23-35-42-974_com.md3music.md3music-edit.png" width="220" alt="MD3Music Material 3 播放页" />
  <img src="img/phone/md3/Screenshot_2026-08-31-23-35-52-228_com.md3music.md3music-edit.png" width="220" alt="MD3Music Material 3 发现页" />
  <img src="img/phone/md3/Screenshot_2026-08-31-23-36-24-517_com.md3music.md3music-edit.png" width="220" alt="MD3Music Material 3 歌词页" />
</p>

MD3Music 是一款基于酷狗音乐 API 的 Flutter 音乐播放器，内置嵌入式 Rust API 服务器，无需外部服务器即可使用。支持手机/平板、Windows 桌面、车机与 Android TV，提供 MD3 与 Apple Music 风格播放页、逐字歌词和多种音频输出能力。本项目仅供学习，请勿用于商业用途，详情见[免责声明](DISCLAIMER.md)。

> **版本说明**：V5 之前的所有版本与分支均已废弃并彻底删除，请勿使用过时版本。最新版请前往 [GitHub Releases](https://github.com/zzyoxml/md3Music/releases)。
>
> 公开仓库代码由脚本从上游仓库全量同步（覆盖式）；直接提交到公开仓的改动可能被下次同步覆盖。
>
> **投屏功能声明**：投屏采用行业标准的通用传输协议（DLNA/AirPlay），仅用于在个人家庭网络内将音乐流转至用户本人合法拥有的播放设备，不涉及对音乐文件的再存储、分发或向公众传播。
>
> 请勿用于公共场所播放或多人同步观看场景，否则由此引发的一切法律责任由使用者自行承担。

***
## 🏆 Trendshift Achievements

<p align="center">
  <a href="https://trendshift.io/repositories/123225"><img src="https://trendshift.io/api/badge/repositories/123225" alt="Featured on GitHub Trending" /></a>
  <a href="https://trendshift.io/repositories/123225"><img src="https://trendshift.io/api/badge/trendshift/repositories/123225/daily?language=Dart" alt="#2 Dart Repository Of The Day on Trendshift" /></a>
</p>
<p align="center">
  <a href="https://trendshift.io/repositories/123225"><img src="https://trendshift.io/api/badge/trendshift/repositories/123225/weekly?language=Dart" alt="#5 Dart Repository Of The Week on Trendshift" /></a>
  <a href="https://trendshift.io/repositories/123225?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-123225" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/123225/monthly?language=Dart" alt="zzyoxml%2Fmd3Music | Trendshift" width="250" height="55"/></a>
</p>

## 📈 GitHub Star 趋势

<p align="center">
  <a href="https://kaiyuanbang.cn/zh-cn/repo/zzyoxml-md3music.html">
    <img src="assets/star-trend.svg" alt="MD3Music 最近 90 天 GitHub Star 趋势" />
  </a>
</p>

> README 中展示的是静态趋势预览。点击图表打开开源榜交互页面后，可将鼠标悬停在曲线上查看对应日期、