00音理音理!· 手机与电脑的音乐播放器

多源在线, 本地优先, 从掌心到桌面

常听的歌,总在不同地方。NeriPlayer 把网易云音乐、哔哩哔哩、YouTube Music 和本地歌曲放进同一个播放器,歌单与记录优先留在本地。在手机或电脑上,都能用熟悉的方式听歌。

支持 Android 9 及以上,另有 Windows、macOS 与 Linux 桌面预览版。免费开源,GPL-3.0。

电脑上也能用:Windows · macOS · Linux 桌面版 ↘

Signals 多源播放 本地优先 自建同步

今晚也一起听歌吗?

Fig. 00 — 音理与黑猫诺瓦,crayon on paper
scroll

01下载 · Download

装上它,马上就能听。

先选手机还是电脑,再挑一个匹配设备的安装包,就能开始听。

沿虚线剪下
NeriPlayer · Android 安装包 免费下载 APK
来自GitHubRELEASES
装到你的手机YOUR PHONE
版本
最新版本
发布于
—
系统要求
Android 9+ · API 28
价格
免费 · GPL-3.0
选择架构 · ABI

SHA-256

第 — 版 累计下载—
01.1

Release 版本推荐

完成一批功能后手动发布,构建 arm64-v8a、armeabi-v7a、x86、x86_64 四个 ABI。它并不是严格意义上的稳定通道,仍可能有尚未暴露的问题。

GitHub Releases ↗
01.3

从源码构建

JDK 17
# 克隆仓库并初始化子模块
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,橙色图标,可与正式版共存。

怎么选 ABI?

arm64-v8a近几年的绝大多数手机与平板
armeabi-v7a老旧的 32 位 ARM 设备
x86_64 / x86模拟器、英特尔设备或 Chromebook

第一次启动

先阅读免责声明并完成启动引导。引导页会说明通知与本地音乐权限,仅在你主动点按后申请,跳过也不影响继续使用。

最近一班列车

  • 正在向 GitHub 查询最新版本……
沿虚线剪下
NeriPlayer · Desktop 预览版 免费下载 PREVIEW
来自GitHubRELEASES
装到你的 WindowsYOUR PC
版本
最新预览版
发布于
—
系统要求
Win 10+ · macOS 10.15+ · WebKitGTK 4.1
价格
免费 · GPL-3.0
系统
选择安装包

SHA-256

第 — 版 累计下载—
01.1

预览版 Release推荐

完成一批功能后发布,提供 Windows、macOS 与 Linux 的安装包,附 SHA256SUMS.txt、macOS 安装说明以及随包 FFmpeg 的源码与构建脚本。反馈问题时请附上「设置 → 关于」里的构建版本。

GitHub Releases ↗
01.3

从源码构建

pnpm 9 · Rust 1.95
# 克隆仓库与歌词子模块
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 就先装运行时
macOSad-hoc 签名、未经公证:拖进「应用程序」打开一次,再到「系统设置 → 隐私与安全性」选「仍要打开」
LinuxAppImage 解压后赋予执行权限;deb / rpm 用发行版的包管理器安装

和手机一起用

在两端的「备份与同步」里连上同一个 GitHub 仓库或 WebDAV 目录就行。第一次遇到旧格式会提示升级,先把其他设备更新到最新再确认;音频文件不会被同步。

最近一班列车

  • 正在向 GitHub 查询最新版本……

02双主题设计 · Themes

两种主题,
两种界面。

白天或入夜,都有合适的样子。Clean 留白简洁,Material You 色彩丰富,两套界面都备好了浅色和深色模式。切换看看,选自己喜欢的那一种。

Clean 用中性色、清晰的字重和悬浮玻璃底栏,让封面与音乐站到前面。

03正在播放 · Now Playing

每一首歌,都有自己的颜色。

放一首歌,封面的颜色也在背景里缓缓流动。切换主题和沉浸布局,点一下播放《星轨》,拖动进度或查看歌词;想安静看看时,下方按钮可随时静音。

从封面里取出颜色,揉成会流动的背景
5种颜色
流体背景需要 Android 13 及以上,更低版本自动换成普通背景
Android13+
预览主题

Media3 / RuntimeShader

01封面取色,生成流体背景

播放页背景由 BgEffectPainter 加载 GLSL / AGSL 着色器,经 RuntimeShader 逐帧渲染:先用 Palette 从封面提取 Base、Accent、Light、Dark、Bridge 五种色彩角色,再把它们揉成流动的色块与颗粒,并接入 uMusicLevel / uBeat 随节拍律动——不是把封面简单地高斯模糊。

Base Accent Light Dark Bridge

手机里的背景就是 App 那份着色器,移植到了 WebGL ↗

WaveformSlider

02进度条和主控,放在顺手的地方

播放时进度条变成一条缓缓流动的波形,暂停后回落成直线;等待缓冲时则换成跳动的脉冲。下方按设置显示音质、编码与规格,例如这首 FLAC 的 RAW · 48 kHz,拖动时还会按歌词时间轴给出触感反馈。

正在播放主控位置

单手握持时,把随机、上一首、播放、下一首和循环挪到拇指够得着的底部,进度条也可以一起下来。主控置底时 Dock 会暂时换成普通工具栏,避免两者重叠。

  1. 01波长约 30 dp、振幅约 2.3 dp,每两秒走完一个周期
  2. 02音质标签可点开切换,倍速不为 1.00× 时会单独标出
  3. 03播放页与歌词页的控件还能分别选小 / 中 / 大三档尺寸

SyncedLyricsView

03封面页也有逐字歌词

控制区下方嵌着一段同步歌词:当前行逐字点亮,翻译只跟在当前行下面,其余行安静地淡在一旁。点一行就跳到那里,长按可以分享;嫌挤的话,封面页歌词和底部工具栏都能单独关掉。

  1. 01封面页 18 sp、翻译 14 sp,可与歌词页分别调整字号
  2. 02向左一滑,就进入完整歌词页
编号NP-01版本—平台Android页码01 / 14
状态Android 9+ · 流体背景与高级模糊需 Android 13+
来源cwuom/NeriPlayer · 3.7k · 131日期—
示例曲《星轨》· Neri Line · NeriPlayer PVNP
《星轨》封面 本地文件
星轨 Neri Line
00:08 01:12

RAW·48 kHz

Fig. 01 — 播放页 · 使用上方控件切换预览

04歌词 · Lyrics

原文与译文,一同亮起。

正在唱的那一句会被点亮,原文与译文上下对照。时间差了半拍,可以手动微调;遇到喜欢的词,还能做成卡片,留给自己或分享给朋友。

星轨Neri Line
00:13 01:12
Fig. 02 — 歌词页,《星轨》的逐字时间轴

LRC / YRC / TTML

02仿 Apple Music 的深度歌词

支持逐行与逐字 LRC(含行尾时间与方括号逐字时间戳)、YRC 与 TTML。歌词页只显示当前歌曲真正可用的选项,切歌后等歌词判定完成再渐入,不会先闪一下空白。

  1. 01点击某一行直接跳转;长按选择歌词,复制文本、分享歌曲或生成 1080px 歌词卡片
  2. 02歌词偏移可按来源分别设置默认值;字号在封面页与歌词页分开调
  3. 03来源偏好:自动 / 网易云 / 酷狗 / QQ 音乐 / LRCLIB / AMLL TTML,手动匹配时优先逐字
  4. 04悬浮歌词、状态栏歌词、SuperLyric、词幕 Lyricon 与蓝牙歌词,复用同一条播放数据

Fig. 02b — 有音译时(示意)

星の線路を そっと辿って

hoshi no senro wo sotto tadotte

遇到带音译数据的日语歌,次级行可以切换成音译:它同样贴在原文正下方,取代译文的位置,而不是悬在原文上面。歌曲没有音译时,这个选项不会出现——就像上面的《星轨》,只有「译」。

Fig.Clean · 真机截图

在手机上,就是这个样子 ↓

Clean 主题真机首页
首页
Clean 主题真机探索页
探索
Clean 主题真机媒体库
媒体库
Clean 主题真机设置页
设置

05多源 · Sources

一个播放器,四条线路。

网易云音乐的歌单、哔哩哔哩的现场、YouTube Music 与本地歌曲,各有值得听的声音。搜索按平台分开,找到的歌可以加入同一份播放队列,下一首接着听。

网易云音乐 · 哔哩哔哩 · YouTube Music
3个在线平台
手机里的歌,连同歌词和封面一起导入
+本地音频
网易云 · 酷狗 · QQ 音乐 · LRCLIB · AMLL TTML
5个歌词来源

登录 · 搜索 · 播放 · 下载 · 评论

01

网易云音乐

从日推、私人 FM 到艺术家详情,网易云是功能最完整的一条线。

  1. 01二维码 / 网页登录;首页同时展示榜单、新歌、日推、私人 FM、雷达与精品歌单
  2. 02歌曲 · 歌单 · 歌手分类搜索,触底自动加载下一页
  3. 03歌单与专辑详情缓存,网络失败时回退到最近一次成功加载的数据
  4. 04艺术家页:热门歌曲与专辑分页,关注后出现在收藏分类里
  5. 05评论:热门 / 最新 / 推荐、楼中楼、点赞、发评与回复,发送失败保留草稿
  6. 06本地「我喜欢的音乐」可同步回网易云
登录✓下载✓
搜索✓歌词✓
歌单✓评论✓

收藏夹 · 合集 · 分 P

02

哔哩哔哩

把视频收藏夹当歌单听:分 P 转音频播放、下载,合集上下文一路保留。

  1. 01Web 登录与二维码登录,视频搜索,创建 / 订阅的收藏夹与合集
  2. 02DASH 音频重试,必要时回退 html5 / mp4 渐进流
  3. 03可选 BilibiliSponsorBlock:只发送 BV 号的 SHA-256 前缀,片段在本地跳过
  4. 04按 BVID + CID 保存自定义跳过区间,可通过 GitHub / WebDAV 同步
  5. 05评论支持热门 / 最新、楼中楼分页、点赞与回复

账号会话 · 播放兼容

03

YouTube Music

国际化模式下首页优先展示 YouTube Music 的歌单与歌曲货架。

  1. 01登录,首页 / 媒体库歌单、歌单详情与搜索
  2. 02登录态 Cookie 与匿名 visitor 会话分别维护,Cookie 轮换受保护
  3. 03PoToken / JS Challenge,bootstrap 与 player.js 缓存优先复用
  4. 04候选被拒时回退 EJS / HLS,不在同一个候选上反复重试
  5. 05可在「设置 > 通用」完全禁用,关闭后不显示入口、不做后台预热

导入 · 扫描 · 归类

04

本地音频

文件夹里的歌,连同旁边的歌词与封面,一起搬进曲库。

  1. 01系统分享 / 打开导入,扫描媒体库或按授权文件夹定向扫描
  2. 02识别 lrc / txt 歌词与 cover / folder / front 封面
  3. 03大批量扫描先快速预览,再在后台补全歌名、歌手、专辑与封面
  4. 04按艺术家自动聚合,拆分 feat. / with / 和 / 与 / 斜杠等合作写法

自动兜底

05

播放兜底

一首歌放不出来时,NeriPlayer 会先想办法,而不是直接报错。

  1. 网易云不可播无权限、无可用结果或只给试听片段
  2. 先降音质依次尝试更低的音质
  3. 改用 Bilibili按歌名、歌手与时长评分匹配
  4. 改用本地音频按稳定元数据匹配可读的本地音频
  5. 仍然异常先刷新播放链接,连续失败再跳过或停止

Bilibili 与本地兜底默认关闭,要自己打开哦

Fig. 03e — 兜底流程

06音质 · Hi-Fi

每一个采样,原样抵达。

接上耳机,认真听一张专辑。手机连接兼容的外置解码器后,可使用 USB 独占输出;在合适的硬件与音源下,让音频绕过系统混音,直接交给解码设备。

  1. 音源FLAC · 24bit / 48kHz
  2. Media3ExoPlayer 解码
  3. 音效链均衡 · 响度 · 倍速
  4. AudioSink32-bit PCM / float
  5. lib_neri.soUSB 独占传输
  6. USB DACUAC1.0 · UAC2.0

比特完美时,绕开音效链 ↷

软件增益 −3.2 dB · 经过音效链
Fig. 04 — 从解码到 DAC 的信号链
  1. 01UAC1.0 · UAC2.0 Type I PCM设备选择、采样率 / 位深 / 缓冲策略与兼容性开关
  2. 02跟随源采样率先按 USB 描述符尝试源采样率,不可用时回退设备兼容采样率
  3. 0332-bit PCMPCM float 软件转换为设备格式
  4. 04显式反馈时钟解析 UAC2 时钟拓扑与反馈端点,长调度间隙后重新捕获
  5. 05卡死自动恢复启动看门狗、健康审计、原地重配置、动态传输扩缩容,必要时回退系统播放
  6. 06前后台无缝按网络或本地来源选择唤醒策略,回到前台后恢复 USB 独占
  7. 07普通输出也讲究32-bit 高解析输出、实时响度均衡、声道平衡、蓝牙断连暂停
  8. 08边界写清楚隐式反馈或无法验证的拓扑会拒绝 Native 候选,走兼容回退

07音效 · Native DSP

想要什么听感,自己拧出来。

每副耳机听起来不同,每个人也有喜欢的声音。手机和电脑共用 29 种音效预设,还能手动调整人声、低音和各个频段。放一首熟悉的歌,慢慢调到顺耳。

按风格、音色、场景与设备分好类,选完还能接着微调
29种内置音效
可拖动的十段图示均衡,外加最多十段参数均衡与 AutoEQ 导入
10+ 10 段均衡
音效关闭或全部为中性时,App 跳过音效处理链路
Bypass中性旁路

Settings · Audio effects & speed

05八个分区,各管一段

顶上是总开关与运行状态:当前输出设备、处理负载与防破音保护。下面八个分区各有自己的开关,关掉只是让这一段按原声走,数值都还在;改过的分区标签旁会亮起一个小圆点。点下面的分区,手机里会跟着翻过去。

拖曲线上的圆点、换个预设,声音会真的跟着变 ↗

星轨Neri Line
Fig. 05 — 设置 · 音效与倍速 · 每个开关都能拧

音效试听由 Web Audio 近似演示,输出由浏览器决定;原生处理效果以 App 为准。

效果监视器模型频谱 · 按播放后换成实时分析

声场100%

输出GR 0.0 dB

  1. 前级Preamp
  2. 均衡Graphic · PEQ
  3. 音调Bass · Treble
  4. 虚拟低音Virtual bass
  5. 音色Warmth · Clarity
  6. 立体声Width · Crossfeed
  7. 环绕Surround
  8. 混响Reverb
  9. 扬声器Speaker
  10. 压缩Compressor
  11. 输出Gain · Limiter

正在处理 · 亮着的环节正在生效

Fig. 05b — App DSP 处理顺序示意;试听与可视化由浏览器近似演示
  1. 01中性即旁路音效关闭、或所有调节都等于原声时整条链路跳过,系统可以继续走硬件低功耗播放
  2. 02三档处理模式省电用简化的混响与压缩、不加抖动;高音质让参数变化更细腻,16 位输出加降噪整形抖动
  3. 03按设备记忆扬声器、有线耳机、蓝牙与 USB 各存一套,插拔或切换输出时自动换上
  4. 04比特完美优先USB 独占默认旁路音效;开启「比特完美输出」时无论如何都不处理
  5. 05预设能分享调好的声音可以存成「我的音效」,复制分享码发给别人一键导入
  6. 06两端一致桌面版同样是原生 DSP,29 种预设、十段均衡、参数均衡与 AutoEQ / Equalizer APO 导入都在

08一起听 · Listen Together

隔着很远,听同一首歌。

和朋友不在一起,也能听同一段副歌。建个房间,分享邀请,让曲目和播放进度随房间同步。隔着一段距离,耳机里仍有共同的旋律。

  1. 01房主 · 听众成员控制开关与控制请求,房主离线检测与恢复
  2. 02同一句歌词,同一秒估算服务端时钟偏移、按漂移阈值校正;单曲循环按时长回绕
  3. 03队列协作拖动、添加与删除按房间版本合并,随机模式复用发起端的真实乱序
  4. 04安全邀请首次加入需要邀请密钥,成员密钥不出现在公开房间状态中
  5. 05候选共享可选共享房主解析的播放候选,每首最多 3 条,不写入离线缓存
LTWWorkers · DO
音理房主
诺瓦听众
狩叶听众

房间 NR7K2Q · 实时同步

Fig. 06 — 三个人,一个房间

09本地与离线 · Local

连接断开,歌还在继续。

没信号的路上,也能有歌相伴。设备里存下的歌曲和已有缓存,断网后仍能继续播放。歌单、记录和设置都留在本机,熟悉的音乐还在手边。

09.1

脱机模式

NetworkStatusMonitor 按系统默认网络承载识别脱机;断网时远程图片请求被阻断,优先用缓存封面。

  • 在线探索与首页刷新
  • 本地文件与已下载歌曲
  • 播放缓存与缓存封面
  • 本地歌单、最近播放与统计
09.2

下载与断点续传

并发 6 · 最高 8
  • 星轨.flac下载中
  • 晚安,列车.mp3下载中
  • Polaris · HLS下载中

不走系统 DownloadManager:直接 HTTP 用 Range 追加,分块传输按偏移续传,HLS 以检查点恢复;队列持久化,重启后自动恢复,手动取消会清理半成品。

09.3

存储占用,一眼看清

  • 音频缓存1.0 GB
  • 图片缓存236 MB
  • 平台歌单缓存142 MB
  • 下载内容896 MB
  • 日志与崩溃报告9 MB
  • 核心应用数据230 MB

清理只覆盖可再生成的缓存,不会把你主动下载的歌当成缓存删掉;音频缓存默认上限 1 GB。

09.4

本地歌手,自动归类

音理 feat. 诺瓦 / 狩叶、花江

音理诺瓦狩叶花江

识别 feat.、with、和 / 与、顿号、分号与斜杠;歌手页可播放全部、多选导出歌单,或批量下载在线歌曲。

09.5

歌单,改错了也不怕

  1. 01删除歌单或歌曲后可以撤销,批量导出也能撤回新增内容
  2. 02选中的歌曲可以整体插到指定序号,先预览前后各 5 首上下文
  3. 03「本地文件」按「手动添加」与「已下载」分类,详情显示累计播放次数
09.6

流量也算得清

区分播放 / 下载流量、Wi‑Fi / 移动 / 漫游与缓存命中;在高风险网络下下载会主动提示。

10同步与隐私 · Sync & Privacy

你的数据,只交给你自己。

换一台设备,喜欢的歌也不必从头整理。用自己的 GitHub 仓库或 WebDAV 网盘,同步歌单、收藏和听歌记录;保存在哪里,由你自己决定。

  1. 01延迟 5 秒 · 每小时一次本地变更后延迟同步,另有周期同步;由 WorkManager 调度,只在已验证的网络下执行
  2. 02三路合并歌单、收藏、历史、删除记录与播放统计参与合并,撤销后的歌曲不会被旧删除记录再次移除
  3. 03V4 增量格式Protobuf 记录流 + ZSTD 分块,单个对象不超过 2 MiB,没变的块不再上传
  4. 04原子发布GitHub 以 GraphQL beforeOid 条件更新;WebDAV 先传不可变对象,再以强 ETag 写清单
  5. 05本地加密Cookie、YouTube 授权、GitHub Token 与 WebDAV 密码存在 Android Keystore + EncryptedSharedPreferences

四条承诺

  1. 01
    不接广告,也不追踪。

    不接入广告 SDK、第三方统计或崩溃分析 SDK。

  2. 02
    不做公共曲库。

    不提供云端媒体分发,也不把个人数据汇聚到维护者手里。

  3. 03
    凭据不出设备。

    不会上传音频缓存、下载文件、Cookie 或播放 Token。

  4. 04
    保护你的账号。

    不把本地播放历史回写第三方平台,避免触发风控与异常登录。

07b播放统计

按歌曲稳定身份记录播放次数、收听时长与每日统计桶,也参与同步合并。

次播放
186
小时收听
11.2
首歌曲
74

收听时长

周 / 月 / 年分别采用近 7 / 30 / 365 天窗口;热点周榜只收录累计收听不少于 10 分钟的歌曲,月榜门槛为 30 分钟。GitHub 仓库与 WebDAV 远端文件都不是端到端加密,请自行妥善保管。

11个性 · Personalize

不只是换个主题色。

每个人顺手的界面,都不太一样。默认打开哪一页、主题颜色、界面大小、歌词字号和首页布局,都能自己调整,慢慢变成你习惯的样子。

界面主题
种子色
深色模式
  1. 01动态取色、种子色与主题风格,自动 / 浅色 / 深色
  2. 02OnePlus 高密度屏会自动叠加 0.95× 修正,用户设置作为额外乘数
  3. 03Android 13+ 可开启进阶高级模糊,12–64 dp 可调,质量分超低 / 低 / 默认 / 高
  4. 04「连贯反馈」让背景与详情页同步接力;关闭时使用抽屉式展开
  5. 05歌词字号与模糊、首页卡片、默认启动页、触感反馈,乃至单曲的名称、歌手与封面

NeriPlayer

继续播放

本地文件10首
Neri Line2首
NeriPlayer PV10首

私人雷达

  1. 1
    PolarisNeri Line / NeriPlayer PV
  2. 2
    Paper PlanetsNeri Line / NeriPlayer PV
  3. 3
    Low OrbitNeri Line / NeriPlayer PV

雷达歌单

雷达时光
雷达
时光雷达15.6亿 · 30首
雷达宝藏
雷达
宝藏雷达8.7亿 · 30首
雷达新歌
雷达
新歌雷达3.6亿 · 30首
雷达乐迷
雷达
乐迷雷达2.8亿 · 30首
雷达神秘
雷达
神秘雷达3791.7万 · 30首

热力飙升

  1. 1
    海边的信号Glass Harbor / NeriPlayer PV
  2. 2
    猫与汽水Soda Cat / NeriPlayer PV
  3. 3
    雨后电台Paper Satellite / NeriPlayer PV

推荐新歌

星轨Neri Line
Fig. 09 — 首页 · Clean / Material You 交互仿真

12平板 · Tablet

屏幕大了,就换一种摆法。

屏幕大了,选歌和看词也更从容。横屏时,封面与歌词并排,设置列表与详情也能同时展开。下面四张是 App 在平板模拟器中的实际画面。

最短边达到 600 dp 就按平板处理,横竖屏随意转
600dp
横屏宽度够 840 dp,换成侧边导航栏与双栏设置
840dp
播放页、媒体库、设置……主要页面都有平板布局
4类页面
平板横屏首页:左侧导航栏、搜索框、三列私人雷达与歌单卡片 1 2 3 4
平板横屏播放页:左栏封面、进度与控制,右栏整页双语歌词 1 2 3 4
平板横屏歌单详情:歌单头部、手动添加与已下载分栏、整宽曲目列表 1 2 3 4
平板横屏设置:左栏分组列表与搜索,右栏直接显示「通用」详情 1 2 3 4
Fig. 10 — Android 平板模拟器 · Clean · 2560 × 1600 横屏
  1. 01底栏换成左侧导航栏,当前页带文字标签
  2. 02搜索与歌单卡片按屏幕宽度展开
  3. 03私人雷达拆成三栏,一屏浏览九首
  4. 04迷你播放器拉成整条:切歌、随机、循环、音量、一起听与队列都在手边
  1. 01封面、进度与控制收在左栏,宽度固定不乱跳
  2. 02歌词直接排在右栏,原文与翻译同屏,不用另开一页
  3. 03波浪进度条、音质标签与五个功能按钮一个不少
  4. 04背景照样从封面取色,铺满整块大屏
  1. 01歌单头部与曲目列表在同一页里滚动
  2. 02「手动添加 / 已下载」分栏切换
  3. 03列表铺满宽度,时长与更多操作靠右对齐
  4. 04悬浮的队列按钮,随时定位正在播放
  1. 01左栏是分组与搜索,结构和手机一致
  2. 02右栏直接显示详情,不用跳页再返回
  3. 03当前分组高亮,左右两栏联动
  4. 04侧边导航栏与迷你播放栏常驻

手机仍锁定竖屏,只有播放页可以横过来;平板竖屏的播放页另有一套布局。

13桌面 · Desktop

搬到电脑上,还是那个音理。

写字、工作的时候,熟悉的歌也在电脑上陪着你。Windows、macOS 与 Linux 预览版支持桌面歌词和快捷键切歌,也能和手机同步歌单,或加入同一个一起听房间。

Windows、macOS(Apple Silicon 与 Intel)与 Linux
3个系统
简体中文、繁体中文、English 与日本語
4种语言
当前为预览版,可以体验与反馈,尚未进入稳定阶段
状态Preview
桌面版首页:左侧导航栏、顶部搜索、继续播放歌单卡片与分三栏的私人雷达,底部是播放栏
Fig. 11a — NeriPlayer Desktop · 1280 × 800 · 每个按钮都能点

预览仿真,不是最终版本界面与功能以实际运行的版本为准。

  1. 01侧边导航:首页、探索、音乐库与设置
  2. 02顶部搜索,回车直接进探索页
  3. 03「继续播放」按打开时间与次数排出最近的歌单
  4. 04底部播放栏:进度贴边,歌词、音量、一起听与队列都在右侧
  1. 01封面带来源角标,背景从封面取色铺成流体
  2. 02AMLL 逐字歌词:当前行点亮,前后行带景深模糊
  3. 03波浪进度条,下方显示实际码率与格式
  4. 04收藏、队列、睡眠定时、音量、音效与加入歌单
  1. 01本地、收藏、下载与各平台歌单分类切换
  2. 02歌单、歌手与本地文件,本地曲库支持多个文件夹
  3. 03歌单可拖拽排序、多选,右键还有更多操作
  4. 04播放统计、最近播放与多选入口
  1. 01封面、名称、曲目数与总时长,网易云歌单还带简介与播放量
  2. 02全部播放、随机与多选,顶部可以在歌单里搜歌
  3. 03曲目行:序号、封面、歌手 · 专辑与时长,点《星轨》就能听
  4. 04首页、音乐库里的歌单卡片都能点进来,左上角返回来处
  1. 01先挑预设,再用「听感调节」的低音、人声、明亮度、温暖感、空间感微调
  2. 02理论频响随均衡器、前级、音调与响度补偿实时更新
  3. 03扬声器优化、动态保护、倍速与唱片效果各成一个分区,可单独恢复
  4. 04和上面手机里那页共用同一份音效,拧哪边另一边跟着变
  1. 0121 个分区分成九组,从账号、播放、音频到备份同步与关于
  2. 02顶部搜索可以直接跳到任意一项设置
  3. 03开关、滑块与分段选项都能拨,折叠分组可以收起再展开
  4. 04键盘快捷键分应用内与全局两套,冲突时会提示

窗口里是从桌面版前端导出的真实界面结构与样式,再接上网页里的播放器;曲目与封面是 NeriPlayer PV 的示例曲,没有登录任何账号。深浅色跟随这一页,系统可以在右上角切换。桌面版仍在预览阶段,仿真只是某一时刻的快照,以实际运行的版本为准。

  1. 01本地曲库多个音乐文件夹,原生文件监视与增量扫描;标题、歌手、专辑可以写回音频文件
  2. 02下载并发 1–8,下载后检查可解码内容与时长;歌词、封面与来源信息随文件保存,重启自动续上队列
  3. 03原生 DSP10 段均衡、最多 10 段参数均衡、AutoEQ / Equalizer APO 导入、29 种预设,按输出设备记忆
  4. 04解码与输出Rust 的 cpal 输出、Symphonia 解码,随包 FFmpeg 再扩展 Opus、ALAC、APE、WavPack 与 DSD
  5. 05歌词AMLL 逐字渲染、翻译与罗马字;QQ 音乐、网易云、酷狗、LRCLIB、AMLL TTML 多源匹配,可逐源偏移
  6. 06系统集成托盘、关闭到托盘、Windows SMTC、Linux MPRIS、macOS Now Playing 与菜单栏歌词
  7. 07和手机互通与 Android 对齐的 V4 ProtoBuf + Zstd 同步格式与合并规则,一起听也是同一个协议
  8. 08界面四种界面语言、深浅色、封面取色、自定义背景与随音频律动的流体背景

Desktop lyrics · Tray · SMTC

11歌词浮在桌面最上层

独立的桌面歌词窗口逐字点亮,可选单行、双行交替或三行滚动,第二行放翻译或下一句;配色、字体、描边、阴影与透明度都能调,锁定后点击穿透,悬停时仍留着解锁按钮。关掉主窗口也能留在托盘继续播放,媒体键与系统媒体会话照常可用。

配色

布局

第二行

拖一拖歌词条,再点右下角托盘里的音理 ↘

Fig. 11b — 桌面歌词、托盘与系统媒体会话 · 可以拖动、点按

应用内快捷键点这里,然后按键盘试试

  • Space播放 / 暂停
  • ←→快退 / 快进 5 秒
  • Shift←→快退 / 快进 30 秒
  • ↑↓音量加 / 减
  • M静音
  • L喜欢
  • D桌面歌词

Windows · macOS · Linux

11b三个系统,各自接上原生能力

同一份 Tauri 2 + Rust 内核,在每个系统上接进它自己的媒体会话、托盘和音频输出。下表是发布工作流的分发目标与源码里的平台实现;托盘、歌词与媒体键的具体呈现仍受系统与桌面环境影响。

能力WindowsmacOSLinux
系统媒体会话SMTC:锁屏、音量浮层与蓝牙耳机按键Now Playing:控制中心与媒体键MPRIS:GNOME / KDE 的媒体控件
托盘与后台通知区域图标,关闭到托盘继续播放菜单栏图标,关闭窗口不退出状态区图标(取决于桌面环境)
歌词桌面歌词,锁定后点击穿透桌面歌词 + 菜单栏歌词桌面歌词,锁定后点击穿透
全局快捷键Ctrl + Alt 组合Cmd + Option 组合Ctrl + Alt 组合
音频输出cpal · WASAPIcpal · CoreAudiocpal · 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

每天都会用到的小细节。

那些每天都会碰到的小地方,也认真照顾到了。桌面小组件、长按快捷入口和迷你播放条手势,让操作少点几下;长音频还会记住上次听到的位置。

14.1

桌面小组件

4×2 · 2×2 · 4×1
4×2 播放卡片小组件预览
4 × 2
2×2 迷你播放器小组件预览
2 × 2
4×1 横条小组件预览
4 × 1

封面取色的 Material You 圆角卡片,适配明暗主题、大字体与横竖屏。宽卡片显示收藏与桌面歌词入口,窄尺寸也保留上一首、播放与下一首;播放时按秒更新已播放时间。

图为 App 自带的小组件预览图。

14.2

启动器快捷方式

长按桌面图标直达;没有可恢复的队列时会给出反馈,而不是静默失败。

14.3

迷你播放器,一滑切歌

底部迷你播放器左右一滑切到上一首 / 下一首,点击展开与播放暂停照旧。

14.4

悬浮与状态栏歌词

悬浮歌词的颜色、描边、字号、位置与对齐都可自定义;支持魅族状态栏歌词、SuperLyric、词幕 Lyricon 与蓝牙歌词。

14.5

车载播放

Android Auto 与支持 AVRCP 浏览的设备可浏览队列与歌单、搜索曲库;连接曲库不会自动播放。

14.6

安全模式

JVM、Native 崩溃与系统 ANR 都会记录现场;上次异常时跳过完整初始化,直接进入安全模式。

14.7

长音频进度记忆

长播客、长视频分 P 自动续上;显式指定的播放位置优先于记忆位置。

14.8

开发者模式

真机上同样是在设置页连点版本号 7 次:底栏会出现 Debug 页,内含各平台探针与日志查看器。

15构造 · Inside

十四个模块,各管一段路。

从播放、歌词到同步,每个听歌的细节都有代码在背后照顾。想了解实现,下面是十四个 Android 模块的分工。代码都在 GitHub 上,觉得好用,欢迎点一颗 Star 支持项目。

Cross-reference 03 播放 04 歌词 05 多源 06 音质 08 一起听 09 本地 10 同步

模块

  • :playback:runtimeMedia3 引擎、音源解析、USB 输出、系统音效
  • :playback:logic播放策略、状态协调、PCM 与队列规则
  • :lyricsLRC / YRC / TTML 解析、翻译对齐、词幕接入
  • :platform网易云、Bilibili、YouTube 协议与账号、评论
  • :nativeUSB 协议、PCM 计算、独占传输,打包 lib_neri.so
  • :listentogether一起听协议、WebSocket、会话与播放同步
  • :download:runtime下载执行、Room 队列、受管文件与恢复
  • :download:logic准入、状态迁移、重试、调度与提交规则
  • :local设置、媒体、歌单、统计、备份与缓存清理
  • :syncGitHub / WebDAV 传输、编解码、合并与调度
  • :databaseRoom 实体、DAO、历史 schema 与升级
  • :network通用 HTTP、Range、网页登录基础能力
  • :model跨模块数据模型与状态契约
  • :common共享工具、日志、文案、图标与语言能力

工具

  • KotlinJava 17 / JVM 17
  • Jetpack Compose单 Activity · NavHost
  • Media3 ExoPlayer播放核心
  • AGSL / GLSLRuntimeShader 流体背景
  • Room · DataStore本地持久化
  • WorkManager同步与下载调度
  • OkHttp · Coil网络与图片
  • KSP设置 schema 生成
  • NDK · C++ · CMakelibusb、独占传输
  • Protobuf · ZSTDV4 同步格式
  • Cloudflare WorkersDurable Objects · WebSocket
  • GitHub ActionsCI、多 ABI 发布、sanitizer 门禁

i常见问题 · FAQ

有什么想问的?

Q.本地歌曲能和在线歌曲放进同一张歌单吗?

可以。在本地歌曲列表中多选歌曲,再用“导出到歌单”加入自建歌单,就能和在线歌曲一起管理。

Discussion #457 ↗

Q.换个设备,歌单和下载的歌都会同步吗?

把设备连到同一个 GitHub 或 WebDAV 同步位置,歌单、收藏、历史和统计就能同步。下载的音频不会一起上传,需要在新设备另外准备。

Issue #178 ↗

Q.原来网易云里缓存的歌,能直接用吗?

一般不能,原版网易云的私有缓存受系统隔离。想减少重复流量,可以在 NeriPlayer 里下载歌曲;文件可用时会优先本地播放。

Discussion #431 ↗

Q.哔哩哔哩可以扫码登录吗?

可以。在“设置→第三方平台登录→哔哩哔哩”选择“扫码登录”,用哔哩哔哩客户端扫码确认后返回 NeriPlayer。二维码页也可以切换到网页登录。

Issue #156 ↗

Q.YouTube Music 登录了,为什么还是打不开?

先用当前网络和账号打开 YouTube Music 网页版,确认能正常使用。它仍受网络、地区和账号限制,登录成功不代表内容一定可访问。

Discussion #602 ↗

Q.有电脑版吗?在哪里下载?

有。NeriPlayer Desktop 支持 Windows、macOS 和 Linux,可以从桌面仓库的 Releases 下载。现在仍是预览版,按自己的系统和芯片选择安装包即可。

Issue #555 ↗

Q.为什么点了循环按钮,还是随机播放?

随机和循环是两个独立开关。要顺序播放,先关闭随机;循环按钮只决定列表播完是否重来,以及是否单曲循环。图标里带“1”表示单曲循环。

Issue #289 ↗

Q.播放页按钮太小,可以单独放大吗?

可以。在“设置→播放页→正在播放控件大小”里选择合适尺寸,顶部按钮、播放控制和底部工具栏会一起调整。歌词页也有独立的控件大小选项。

Issue #271 ↗

Q.歌词翻译和音译在哪里切换?

打开“正在播放→更多→调整歌词行为”,可以控制第二行歌词。歌曲同时带有翻译和音译时,先打开“显示歌词翻译”,再用“音译显示”切换。

Issue #365 ↗

Q.开启高级歌词后,为什么有些歌仍不能逐字显示?

逐字显示需要歌词本身带有每个字的时间信息。可以在“获取歌曲信息”中换一个歌词源或歌曲版本,匹配带逐字数据的歌词。

Issue #412 ↗

Q.下载的歌在其他播放器里歌词不正常,怎么办?

可以在下载设置里开启“元信息后处理”和“标准化歌词嵌入”,再重新下载试试。后者会把写入音频的逐字歌词转成更通用的逐行 LRC,方便其他播放器识别。

Issue #362 ↗

Q.USB 独占播放时,怎样调节音量?

关闭“比特完美输出”时,音量键、锁屏和系统音量面板都能调节音量。开启后,音量键会调 DAC 的硬件音量,需要 DAC 支持;不支持时可关闭比特完美再调节。

Discussion #296 ↗