NeriPlayer

[English](./README_EN.md) | [中文](./README.md)

<h1 align="center">NeriPlayer (音理音理!)</h1>

<div align="center">

<h3>✨ 聚合多平台音源、本地曲库、自建音乐服务器（预览版）与逐字歌词的原生 Android 音频播放器 🎵</h3>

<p><strong>🖥️ 在找 PC 端吗？ <a href="https://github.com/cwuom/NeriPlayer-Desktop">前往 NeriPlayer Desktop 仓库 →</a></strong></p>

<p>
  <a href="https://github.com/cwuom/NeriPlayer/releases">
    <img alt="Downloads" src="https://img.shields.io/github/downloads/cwuom/NeriPlayer/total?style=social" />
  </a>
  <a href="https://github.com/cwuom/NeriPlayer/releases">
    <img alt="Release" src="https://img.shields.io/github/v/release/cwuom/NeriPlayer?include_prereleases&label=Release" />
  </a>
  <img alt="Android 9+" src="https://img.shields.io/badge/Android-9%2B-3DDC84?logo=android&logoColor=white" />
  <a href="https://t.me/ouom_pub">
    <img alt="Telegram" src="https://img.shields.io/badge/Telegram-@ouom__pub-blue" />
  </a>
  <a href="https://t.me/neriplayer_ci">
    <img alt="CI Builds" src="https://img.shields.io/badge/CI_Builds-@neriplayer__ci-orange" />
  </a>
</p>

<p>
  <img src="icon/readme-banner.svg" width="100%" alt="NeriPlayer — Modern Music Player" />
</p>

<p>
本项目的名称及图标灵感来源于《星空鉄道とシロの旅》中的角色「风又音理」。
</p>

<p>
项目采用原生 Android 开发，支持 Android 9 (API 28) 及以上设备，
围绕「多源探索、在线播放、本地可控、数据自持」持续打磨。
</p>

🛠️ <strong>Active development / 持续迭代中</strong>

<a href="https://trendshift.io/repositories/23906" target="_blank"><img src="https://trendshift.io/api/badge/repositories/23906" alt="cwuom%2FNeriPlayer | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

</div>

> [!WARNING]
> **自建音乐服务器功能目前为预览版本，缺乏充分测试。**

---

> [!WARNING]
> 本项目仅供学习与研究使用，请勿将其用于任何非法用途。
> 请只在你拥有权利、授权或第三方平台规则允许的范围内访问、播放或保存内容。
> 本项目不提供媒体内容、密钥、规避付费/DRM/地区限制的方案，也不提供公共媒体代理或再分发服务。
>
> NeriPlayer 不提供公共云端曲库或媒体分发服务。在线音频能力依赖用户在第三方平台上的账号授权，
> 会员或受限内容仍需遵循原平台规则。文档中提到的 YouTube Music 相关能力仅指账号会话、
> 播放兼容和错误恢复，不代表绕过平台限制、复制受保护内容或重新分发媒体。
>
> 本项目及维护者不接受任何形式的赞助、捐赠或商业资助。

---

## 快速定位 / Start here

| 快速导航 | 说明 |
| :--- | :--- |
| [快速体验](#快速体验--getting-started) | 下载安装 APK、获取 CI 构建或从源码编译 |
| [核心特性](#核心特性--key-features) & [平台现状](#平台现状--platform-status) | 了解播放、音效、歌词、本地管理能力与各平台支持范围 |
| [连接音乐服务器](#连接音乐服务器) | 接入 Navidrome / OpenSubsonic 自建音乐库（预览版） |
| [一起听服务端部署](#一起听服务端部署--listen-together-deployment) | 使用 Cloudflare Workers 自建实时同步听歌房间 |
| [docs/implementation.md](./docs/implementation.md) | 架构、模块职责、启动链路与测试护栏等实现细节 |
| [CONTRIBUTING.md](./CONTRIBUTING.md) | 开发环境配置、提交流程与代码贡献指南 |

| 能力维度 | 核心亮点 |
| :--- | :--- |
| **多源在线与自建库** | 网易云音乐、Bilibili、YouTube Music、本地音频与 Navidrome / OpenSubsonic（预览版）共用统一播放队列 |
| **高阶歌词体验** | LRC / YRC / TTML 逐行与逐字歌词、B 站 CC 字幕、翻译音译、多源匹配，支持悬浮窗、状态栏、蓝牙/车载与系统级歌词输出 |
| **专业音频与视觉** | Media3 播放引擎、自研 DSP、10 段 EQ、AutoEQ、32-bit 输出、USB 独占；Material You 与 Clean 主题、流体背景、桌面小组件、启动器快捷方式 |
| **本地优先与自有同步** | 缓存、下载、歌单、历史、统计与设置默认保存在本地；可选将元数据同步至你自己的 GitHub 仓库（新建时默认私有）或 WebDAV 远端 |
| **可恢复运行** | 内置脱机模式、安全模式、JVM/Native 崩溃日志、ANR 记录与调试探针 |

## 项目简介 / About

NeriPlayer 是一个基于 **Jetpack Compose + Media3** 的原生 Android 音频播放器，将 **网