Release 版本推荐
完成一批功能后手动发布,构建 arm64-v8a、armeabi-v7a、x86、x86_64 四个 ABI。它并不是严格意义上的稳定通道,仍可能有尚未暴露的问题。
GitHub Releases ↗00音理音理!· 手机与电脑的音乐播放器
常听的歌,总在不同地方。NeriPlayer 把网易云音乐、哔哩哔哩、YouTube Music 和本地歌曲放进同一个播放器,歌单与记录优先留在本地。在手机或电脑上,都能用熟悉的方式听歌。
支持 Android 9 及以上,另有 Windows、macOS 与 Linux 桌面预览版。免费开源,GPL-3.0。
电脑上也能用:Windows · macOS · Linux 桌面版 ↘
Signals 多源播放 本地优先 自建同步
今晚也一起听歌吗?
01下载 · Download
先选手机还是电脑,再挑一个匹配设备的安装包,就能开始听。
SHA-256
完成一批功能后手动发布,构建 arm64-v8a、armeabi-v7a、x86、x86_64 四个 ABI。它并不是严格意义上的稳定通道,仍可能有尚未暴露的问题。
GitHub Releases ↗master 分支每次成功构建都会上传 arm64-v8a APK,想第一时间尝鲜可以从这里取。
# 克隆仓库并初始化子模块
git clone --recursive https://github.com/cwuom/NeriPlayer.git
cd NeriPlayer
# 构建调试版并安装
./gradlew :app:assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk
DEBUG 包名 moe.ouom.neriplayer.debug,橙色图标,可与正式版共存。
| arm64-v8a | 近几年的绝大多数手机与平板 |
|---|---|
| armeabi-v7a | 老旧的 32 位 ARM 设备 |
| x86_64 / x86 | 模拟器、英特尔设备或 Chromebook |
先阅读免责声明并完成启动引导。引导页会说明通知与本地音乐权限,仅在你主动点按后申请,跳过也不影响继续使用。
SHA-256
完成一批功能后发布,提供 Windows、macOS 与 Linux 的安装包,附 SHA256SUMS.txt、macOS 安装说明以及随包 FFmpeg 的源码与构建脚本。反馈问题时请附上「设置 → 关于」里的构建版本。
想体验还没发布的改动,可以到 Artifacts 工作流挑一次成功的构建,下载对应平台的产物;需要登录 GitHub,先解压外层压缩包再安装。
# 克隆仓库与歌词子模块
git clone --recursive https://github.com/cwuom/NeriPlayer-Desktop.git
cd NeriPlayer-Desktop
pnpm install --frozen-lockfile
# 启动 Vite 与 Tauri 开发窗口
pnpm tauri dev
还需要 Tauri 平台依赖,以及编译 FFmpeg C++ 垫片的工具链。
| Windows | 安装包暂未代码签名,SmartScreen 拦下时选「更多信息 → 仍要运行」;缺 WebView2 就先装运行时 |
|---|---|
| macOS | ad-hoc 签名、未经公证:拖进「应用程序」打开一次,再到「系统设置 → 隐私与安全性」选「仍要打开」 |
| Linux | AppImage 解压后赋予执行权限;deb / rpm 用发行版的包管理器安装 |
在两端的「备份与同步」里连上同一个 GitHub 仓库或 WebDAV 目录就行。第一次遇到旧格式会提示升级,先把其他设备更新到最新再确认;音频文件不会被同步。
02双主题设计 · Themes
白天或入夜,都有合适的样子。Clean 留白简洁,Material You 色彩丰富,两套界面都备好了浅色和深色模式。切换看看,选自己喜欢的那一种。
Clean 用中性色、清晰的字重和悬浮玻璃底栏,让封面与音乐站到前面。
03正在播放 · Now Playing
放一首歌,封面的颜色也在背景里缓缓流动。切换主题和沉浸布局,点一下播放《星轨》,拖动进度或查看歌词;想安静看看时,下方按钮可随时静音。
Media3 / RuntimeShader
播放页背景由 BgEffectPainter 加载 GLSL / AGSL 着色器,经 RuntimeShader 逐帧渲染:先用 Palette 从封面提取 Base、Accent、Light、Dark、Bridge 五种色彩角色,再把它们揉成流动的色块与颗粒,并接入 uMusicLevel / uBeat 随节拍律动——不是把封面简单地高斯模糊。
手机里的背景就是 App 那份着色器,移植到了 WebGL ↗
WaveformSlider
播放时进度条变成一条缓缓流动的波形,暂停后回落成直线;等待缓冲时则换成跳动的脉冲。下方按设置显示音质、编码与规格,例如这首 FLAC 的 RAW · 48 kHz,拖动时还会按歌词时间轴给出触感反馈。
正在播放主控位置
单手握持时,把随机、上一首、播放、下一首和循环挪到拇指够得着的底部,进度条也可以一起下来。主控置底时 Dock 会暂时换成普通工具栏,避免两者重叠。
SyncedLyricsView
控制区下方嵌着一段同步歌词:当前行逐字点亮,翻译只跟在当前行下面,其余行安静地淡在一旁。点一行就跳到那里,长按可以分享;嫌挤的话,封面页歌词和底部工具栏都能单独关掉。
| 编号NP-01 | 版本— | 平台Android | 页码01 / 14 |
| 状态Android 9+ · 流体背景与高级模糊需 Android 13+ | |||
| 来源cwuom/NeriPlayer · 3.7k · 131 | 日期— | ||
| 示例曲《星轨》· Neri Line · NeriPlayer PV | NP | ||
RAW·48 kHz
04歌词 · Lyrics
正在唱的那一句会被点亮,原文与译文上下对照。时间差了半拍,可以手动微调;遇到喜欢的词,还能做成卡片,留给自己或分享给朋友。
LRC / YRC / TTML
支持逐行与逐字 LRC(含行尾时间与方括号逐字时间戳)、YRC 与 TTML。歌词页只显示当前歌曲真正可用的选项,切歌后等歌词判定完成再渐入,不会先闪一下空白。
Fig. 02b — 有音译时(示意)
星の線路を そっと辿って
hoshi no senro wo sotto tadotte
遇到带音译数据的日语歌,次级行可以切换成音译:它同样贴在原文正下方,取代译文的位置,而不是悬在原文上面。歌曲没有音译时,这个选项不会出现——就像上面的《星轨》,只有「译」。
Fig.Clean · 真机截图
在手机上,就是这个样子 ↓
05多源 · Sources
网易云音乐的歌单、哔哩哔哩的现场、YouTube Music 与本地歌曲,各有值得听的声音。搜索按平台分开,找到的歌可以加入同一份播放队列,下一首接着听。
登录 · 搜索 · 播放 · 下载 · 评论
从日推、私人 FM 到艺术家详情,网易云是功能最完整的一条线。
| 登录 | ✓ | 下载 | ✓ |
|---|---|---|---|
| 搜索 | ✓ | 歌词 | ✓ |
| 歌单 | ✓ | 评论 | ✓ |
收藏夹 · 合集 · 分 P
把视频收藏夹当歌单听:分 P 转音频播放、下载,合集上下文一路保留。
BVID + CID 保存自定义跳过区间,可通过 GitHub / WebDAV 同步账号会话 · 播放兼容
国际化模式下首页优先展示 YouTube Music 的歌单与歌曲货架。
player.js 缓存优先复用导入 · 扫描 · 归类
文件夹里的歌,连同旁边的歌词与封面,一起搬进曲库。
lrc / txt 歌词与 cover / folder / front 封面自动兜底
一首歌放不出来时,NeriPlayer 会先想办法,而不是直接报错。
Bilibili 与本地兜底默认关闭,要自己打开哦
分享文案 → 详情页
探索页的「链接识别」可以粘贴链接,也可以粘贴含标题和短链接的整段文案。
season_id 合集上下文;暂无详情页的类型会明确提示06音质 · Hi-Fi
接上耳机,认真听一张专辑。手机连接兼容的外置解码器后,可使用 USB 独占输出;在合适的硬件与音源下,让音频绕过系统混音,直接交给解码设备。
比特完美时,绕开音效链 ↷
07音效 · Native DSP
每副耳机听起来不同,每个人也有喜欢的声音。手机和电脑共用 29 种音效预设,还能手动调整人声、低音和各个频段。放一首熟悉的歌,慢慢调到顺耳。
Settings · Audio effects & speed
顶上是总开关与运行状态:当前输出设备、处理负载与防破音保护。下面八个分区各有自己的开关,关掉只是让这一段按原声走,数值都还在;改过的分区标签旁会亮起一个小圆点。点下面的分区,手机里会跟着翻过去。
拖曲线上的圆点、换个预设,声音会真的跟着变 ↗
音效试听由 Web Audio 近似演示,输出由浏览器决定;原生处理效果以 App 为准。
效果监视器模型频谱 · 按播放后换成实时分析
声场100%
输出GR 0.0 dB
正在处理 · 亮着的环节正在生效
08一起听 · Listen Together
和朋友不在一起,也能听同一段副歌。建个房间,分享邀请,让曲目和播放进度随房间同步。隔着一段距离,耳机里仍有共同的旋律。
房间 NR7K2Q · 实时同步
09本地与离线 · Local
没信号的路上,也能有歌相伴。设备里存下的歌曲和已有缓存,断网后仍能继续播放。歌单、记录和设置都留在本机,熟悉的音乐还在手边。
NetworkStatusMonitor 按系统默认网络承载识别脱机;断网时远程图片请求被阻断,优先用缓存封面。
不走系统 DownloadManager:直接 HTTP 用 Range 追加,分块传输按偏移续传,HLS 以检查点恢复;队列持久化,重启后自动恢复,手动取消会清理半成品。
清理只覆盖可再生成的缓存,不会把你主动下载的歌当成缓存删掉;音频缓存默认上限 1 GB。
音理 feat. 诺瓦 / 狩叶、花江
音理诺瓦狩叶花江
识别 feat.、with、和 / 与、顿号、分号与斜杠;歌手页可播放全部、多选导出歌单,或批量下载在线歌曲。
区分播放 / 下载流量、Wi‑Fi / 移动 / 漫游与缓存命中;在高风险网络下下载会主动提示。
10同步与隐私 · Sync & Privacy
换一台设备,喜欢的歌也不必从头整理。用自己的 GitHub 仓库或 WebDAV 网盘,同步歌单、收藏和听歌记录;保存在哪里,由你自己决定。
beforeOid 条件更新;WebDAV 先传不可变对象,再以强 ETag 写清单不接入广告 SDK、第三方统计或崩溃分析 SDK。
不提供云端媒体分发,也不把个人数据汇聚到维护者手里。
不会上传音频缓存、下载文件、Cookie 或播放 Token。
不把本地播放历史回写第三方平台,避免触发风控与异常登录。
按歌曲稳定身份记录播放次数、收听时长与每日统计桶,也参与同步合并。
收听时长
周 / 月 / 年分别采用近 7 / 30 / 365 天窗口;热点周榜只收录累计收听不少于 10 分钟的歌曲,月榜门槛为 30 分钟。GitHub 仓库与 WebDAV 远端文件都不是端到端加密,请自行妥善保管。
11个性 · Personalize
每个人顺手的界面,都不太一样。默认打开哪一页、主题颜色、界面大小、歌词字号和首页布局,都能自己调整,慢慢变成你习惯的样子。
NeriPlayer
继续播放
私人雷达
雷达歌单
热力飙升
推荐新歌
12平板 · Tablet
屏幕大了,选歌和看词也更从容。横屏时,封面与歌词并排,设置列表与详情也能同时展开。下面四张是 App 在平板模拟器中的实际画面。
手机仍锁定竖屏,只有播放页可以横过来;平板竖屏的播放页另有一套布局。
13桌面 · Desktop
写字、工作的时候,熟悉的歌也在电脑上陪着你。Windows、macOS 与 Linux 预览版支持桌面歌词和快捷键切歌,也能和手机同步歌单,或加入同一个一起听房间。
预览仿真,不是最终版本界面与功能以实际运行的版本为准。
窗口里是从桌面版前端导出的真实界面结构与样式,再接上网页里的播放器;曲目与封面是 NeriPlayer PV 的示例曲,没有登录任何账号。深浅色跟随这一页,系统可以在右上角切换。桌面版仍在预览阶段,仿真只是某一时刻的快照,以实际运行的版本为准。
Desktop lyrics · Tray · SMTC
独立的桌面歌词窗口逐字点亮,可选单行、双行交替或三行滚动,第二行放翻译或下一句;配色、字体、描边、阴影与透明度都能调,锁定后点击穿透,悬停时仍留着解锁按钮。关掉主窗口也能留在托盘继续播放,媒体键与系统媒体会话照常可用。
配色
布局
第二行
拖一拖歌词条,再点右下角托盘里的音理 ↘
应用内快捷键点这里,然后按键盘试试
Windows · macOS · Linux
同一份 Tauri 2 + Rust 内核,在每个系统上接进它自己的媒体会话、托盘和音频输出。下表是发布工作流的分发目标与源码里的平台实现;托盘、歌词与媒体键的具体呈现仍受系统与桌面环境影响。
你正在用Windows
| 能力 | Windows | macOS | Linux |
|---|---|---|---|
| 系统媒体会话 | SMTC:锁屏、音量浮层与蓝牙耳机按键 | Now Playing:控制中心与媒体键 | MPRIS:GNOME / KDE 的媒体控件 |
| 托盘与后台 | 通知区域图标,关闭到托盘继续播放 | 菜单栏图标,关闭窗口不退出 | 状态区图标(取决于桌面环境) |
| 歌词 | 桌面歌词,锁定后点击穿透 | 桌面歌词 + 菜单栏歌词 | 桌面歌词,锁定后点击穿透 |
| 全局快捷键 | Ctrl + Alt 组合 | Cmd + Option 组合 | Ctrl + Alt 组合 |
| 音频输出 | cpal · WASAPI | cpal · CoreAudio | cpal · ALSA |
| 安装包 | .exe(NSIS)· .msi | .dmg · Apple Silicon / Intel | .deb · .rpm · AppImage |
| 系统要求 | x64 · WebView2 运行时 | Apple Silicon 11.0+ · Intel 10.15+ | x64 · WebKitGTK 4.1 · GTK 3 |
| 第一次打开 | 未做代码签名,SmartScreen 里选「仍要运行」 | ad-hoc 签名,在「隐私与安全性」里「仍要打开」 | AppImage 解压后赋予执行权限 |
桌面版不做应用内自动更新,新版本到 Releases 手动下载。USB 独占、SAF 与状态栏歌词属于 Android 版,桌面端用托盘、桌面歌词、媒体会话与快捷键补上。
14细节 · Details
那些每天都会碰到的小地方,也认真照顾到了。桌面小组件、长按快捷入口和迷你播放条手势,让操作少点几下;长音频还会记住上次听到的位置。
封面取色的 Material You 圆角卡片,适配明暗主题、大字体与横竖屏。宽卡片显示收藏与桌面歌词入口,窄尺寸也保留上一首、播放与下一首;播放时按秒更新已播放时间。
图为 App 自带的小组件预览图。
长按桌面图标直达;没有可恢复的队列时会给出反馈,而不是静默失败。
底部迷你播放器左右一滑切到上一首 / 下一首,点击展开与播放暂停照旧。
悬浮歌词的颜色、描边、字号、位置与对齐都可自定义;支持魅族状态栏歌词、SuperLyric、词幕 Lyricon 与蓝牙歌词。
Android Auto 与支持 AVRCP 浏览的设备可浏览队列与歌单、搜索曲库;连接曲库不会自动播放。
JVM、Native 崩溃与系统 ANR 都会记录现场;上次异常时跳过完整初始化,直接进入安全模式。
长播客、长视频分 P 自动续上;显式指定的播放位置优先于记忆位置。
真机上同样是在设置页连点版本号 7 次:底栏会出现 Debug 页,内含各平台探针与日志查看器。
15构造 · Inside
从播放、歌词到同步,每个听歌的细节都有代码在背后照顾。想了解实现,下面是十四个 Android 模块的分工。代码都在 GitHub 上,觉得好用,欢迎点一颗 Star 支持项目。
i常见问题 · FAQ
可以。在本地歌曲列表中多选歌曲,再用“导出到歌单”加入自建歌单,就能和在线歌曲一起管理。
把设备连到同一个 GitHub 或 WebDAV 同步位置,歌单、收藏、历史和统计就能同步。下载的音频不会一起上传,需要在新设备另外准备。
一般不能,原版网易云的私有缓存受系统隔离。想减少重复流量,可以在 NeriPlayer 里下载歌曲;文件可用时会优先本地播放。
可以。在“设置→第三方平台登录→哔哩哔哩”选择“扫码登录”,用哔哩哔哩客户端扫码确认后返回 NeriPlayer。二维码页也可以切换到网页登录。
先用当前网络和账号打开 YouTube Music 网页版,确认能正常使用。它仍受网络、地区和账号限制,登录成功不代表内容一定可访问。
有。NeriPlayer Desktop 支持 Windows、macOS 和 Linux,可以从桌面仓库的 Releases 下载。现在仍是预览版,按自己的系统和芯片选择安装包即可。
随机和循环是两个独立开关。要顺序播放,先关闭随机;循环按钮只决定列表播完是否重来,以及是否单曲循环。图标里带“1”表示单曲循环。
可以。在“设置→播放页→正在播放控件大小”里选择合适尺寸,顶部按钮、播放控制和底部工具栏会一起调整。歌词页也有独立的控件大小选项。
打开“正在播放→更多→调整歌词行为”,可以控制第二行歌词。歌曲同时带有翻译和音译时,先打开“显示歌词翻译”,再用“音译显示”切换。
逐字显示需要歌词本身带有每个字的时间信息。可以在“获取歌曲信息”中换一个歌词源或歌曲版本,匹配带逐字数据的歌词。
可以在下载设置里开启“元信息后处理”和“标准化歌词嵌入”,再重新下载试试。后者会把写入音频的逐字歌词转成更通用的逐行 LRC,方便其他播放器识别。
关闭“比特完美输出”时,音量键、锁屏和系统音量面板都能调节音量。开启后,音量键会调 DAC 的硬件音量,需要 DAC 支持;不支持时可关闭比特完美再调节。