NeriPlayer：多源聚合的 Android 音乐播放器

项目简介

NeriPlayer 是一个基于 Jetpack Compose + Media3 的原生 Android 音频播放器，支持 Android 9（API 28）及以上设备。它把网易云音乐、Bilibili、YouTube Music、本地音乐与 Navidrome / OpenSubsonic 自建音乐服务器整合到统一的播放队列与媒体库中，围绕「多源探索、在线播放、本地可控、数据自持」进行设计。

本地播放不需要任何第三方平台账号；在线功能使用你在对应平台上的账号授权。缓存、下载、歌单、历史、统计与设置默认保存在设备本地，可选同步到你自己控制的 GitHub 仓库或 WebDAV 远端，不经过维护者服务器。项目名称与图标灵感来源于《星空鉄道とシロの旅》中的角色「风又音理」。

主要功能

播放与音质

• 网易云、Bilibili、YouTube Music 与本地音频共用一个播放队列。
• 网易云不可播时先降音质；开启兜底后按歌名、歌手与时长匹配 Bilibili 候选，连续失败自动跳过。
• 自研 DSP 提供内置音效、10 段均衡器、AutoEQ 导入、响度均衡与 32-bit 高解析输出，关闭即完全旁路。
• USB 独占输出支持 UAC1.0 与兼容 UAC2.0 Type I PCM 的 DAC。
• 淡入淡出、切歌交叉淡入淡出、蓝牙断连暂停、音频焦点策略，并恢复上次播放进度与播放模式。

歌词

• LRC / YRC / TTML 逐行与逐字歌词，支持翻译、音译、偏移、点击跳转与全屏歌词。
• B 站歌曲可直接使用视频 CC 字幕作为歌词，可选择字幕轨道。
• 来源可按偏好自动选择（网易云 / 酷狗 / QQ 音乐 / LRCLIB / AMLL），支持手动匹配与编辑。
• 可输出到悬浮歌词、状态栏歌词、SuperLyric、Lyricon、蓝牙与车载显示。

媒体库、下载与同步

• 本地、收藏、网易云、YouTube Music、Bilibili 分区浏览；首页提供榜单、新歌、日推、私人 FM 等推荐。
• 粘贴分享文案即可识别网易云、Bilibili 与 YouTube 内容；支持分享导入与文件夹扫描，可批量为本地歌曲匹配歌词与封面。
• 应用内多平台下载、断点续传与启动恢复，默认并发 6（可调 1–8）；支持 SAF 自定义目录与文件名模板。
• 播放与流量统计，歌单 JSON 导入导出，配置导出可选择加密并包含授权信息。
• 「一起听」通过 WebSocket 实时同步播放状态，房间号 6 位，首次加入需邀请密钥。

界面与稳定性

• Material You 与预览版「简洁（Clean）」双界面风格，后者可开启液态玻璃效果；播放页有随封面取色的流体背景（Android 13+）。
• 三种尺寸桌面小组件、启动器快捷方式、平板横屏歌词分栏。
• 内置脱机模式、安全模式、崩溃日志与 ANR 记录；设置页连续点击版本号 7 次可启用开发者模式。

安装与使用

推荐前往 GitHub Releases 下载对应架构的 APK：arm64-v8a 适用于绝大多数现代手机与平板，armeabi-v7a 面向老旧 32 位设备，x86 / x86_64 用于模拟器或 Intel 设备。

从源码构建需 JDK 17 与 Android Studio：

git clone --recursive https://github.com/cwuom/NeriPlayer.git
./gradlew :app:assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk

首次启动需阅读免责声明并完成引导，通知与本地音乐权限仅在主动点按后申请。

接入自建音乐库：在「设置 → 第三方平台登录 → 音乐服务器」填写名称、地址、用户名和密码，地址形如 https://music.example.com:4533/navidrome/，不含 /app/ 或 /rest/；随后在「资源库 → 音乐服务器」浏览、搜索与下载。

注意事项

• 自建音乐服务器功能目前为预览版本，缺乏充分测试，服务器回写、一起听与配置迁移尚未接入。
• 本项目仅供学习与研究使用，请只在拥有权利、授权或平台规则允许的范围内访问、播放或保存内容；项目不提供媒体内容、密钥，也不提供规避付费/DRM/地区限制的方案。
• 在线音频能力依赖用户在第三方平台上的账号授权，会员或受限内容仍需遵循原平台规则。
• Release 渠道并非严格意义上的稳定通道，版本可能包含未充分暴露的问题；DEBUG 构建仅用于测试。
• 项目不接受任何形式的赞助、捐赠或商业资助。

本作品整理自 GitHub 开源项目 cwuom/NeriPlayer，原作者 @cwuom，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。