Mineradio:4.5k 星的沉浸式电影感音乐播放器,天气电台+粒子视觉
上线不到一个月,4.5k 星、338 forks、145+ issues——Mineradio 是最近 GitHub 上蹿升最快的桌面音乐播放器。它不是又一个音乐客户端,而是一个把天气电台、粒子视觉、电影镜头运镜、歌词舞台、3D 歌单架塞进一个 Electron 应用里的沉浸式音乐空间。支持网易云音乐和 QQ 音乐双平台,GPL-3.0 开源。
一、它是什么

Mineradio 是一个 Windows 桌面沉浸式音乐播放器,由 XxHuberrr 独立开发。和普通播放器不同,它的核心卖点不是音质或格式支持,而是视觉体验——用粒子特效、电影镜头运镜、节拍驱动的动画效果,把听歌变成一种沉浸式的”私人演唱会”。
项目 2026 年 6 月 2 日上线,不到一个月就冲到 4.5k 星。社区非常活跃,已经衍生出多个 macOS fork、一个 Rust 移植版、一个 Web 版,甚至还有基于 Mineradio 的魔改版。
二、核心功能
天气电台:基于 Open-Meteo API,根据你的位置、城市和当前天气自动生成音乐队列。下雨天听舒缓的,晴天听轻快的——不用自己挑歌。
粒子视觉系统:播放音乐时,屏幕上会出现粒子特效,跟随节拍律动。支持 WebGL 着色器渲染,有电影镜头运镜效果(zoom、pan、dolly)。
歌词舞台:自定义歌词显示,支持歌词定位和视觉控制。歌词和粒子特效同步工作。
DJ/Podcast 视觉模式:针对长音频(播客、DJ 混音)有专门的视觉模式,内置节拍分析器(dj-analyzer.js,34KB)。
3D 歌单架:右键召唤一个 3D 歌单架,可视化浏览播放队列。
双音乐平台:支持网易云音乐(账号登录、搜索、歌单、播客)和 QQ 音乐(搜索、登录、音源补充)。
桌面歌词:支持桌面级歌词显示,音量键控制。
自定义封面:支持上传和裁剪自定义专辑封面。
4 组视觉预设:粒子/颜色/滑块/歌词偏好可以保存到 4 个槽位,随时切换。
三、技术栈
| 层 | 技术 |
|---|---|
| 桌面壳 | Electron v42.4.1 |
| 后端 | Node.js(server.js,168KB) |
| 前端 | HTML/JS/CSS(单体 index.html) |
| 动画 | GSAP v3.15 |
| 音频解码 | mpg123-decoder |
| 音乐 API | NeteaseCloudMusicApi v4.32 |
| 视觉效果 | WebGL 着色器(粒子系统、电影镜头、splash 动画) |
| 节拍分析 | 自研 dj-analyzer.js(34KB) |
| 打包 | electron-builder v26.15 + NSIS 安装器 |
四、版本历程
Mineradio 的版本迭代非常密集:
| 版本 | 亮点 |
|---|---|
| v0.9.9 | 首个公开版本,GitHub 更新系统,双平台支持 |
| v1.0.0 | 正式版——天气电台、首页、Emily 视觉、稳定性修复 |
| v1.0.8 | QQ 音乐登录修复、视觉预设槽位、淡入淡出 |
| v1.0.9 | 安装器 UI 修复、安装目录选择、单例锁 |
| v1.0.10 | 桌面歌词重设计、音量键、补丁规则变更 |
| v1.1.0 | 干净安装发布、默认视觉预设、3D 架修复、性能设置 |
| v1.1.1 | 安装器安全修复——默认 D 盘、安全卸载器、遗留清理 |
五、社区生态
Mineradio 的社区生态非常活跃,已经衍生出多个项目:
macOS 移植:至少 5 个社区 fork 在做 macOS 版本(CAS9877、YiIimini、Mac-XK 等),多个 PR 在推进官方 macOS 支持。
Rust 移植:qinye6/Mineradio-rust 正在用 Rust 重写。
Web 版:MrChenyh/Mineradio-Web 做了 Web 适配。
魔改版:JS1Lan/Lanote 基于 Mineradio 做了深度定制。
Tauri 重写:社区成员 zzstar101 正在用 Tauri+React+Vite 重写,目标是减小包体积和提升性能。
六、已知问题
社区反馈中有一些值得注意的问题:
卸载器安全问题(Issue #20、#123):早期版本的 NSIS 卸载器会删除整个父目录,有用户丢失了 60GB 数据。v1.1.1 已修复,默认安装到 D 盘,安全卸载器。
启动崩溃(Issue #10、#99、#141):部分用户报告启动时崩溃(异常码 0x80000003),可能与 Electron/Chromium 原生层有关。
栈溢出(Issue #17):切换歌曲时 CPU 飙升和栈溢出崩溃,原因是 beginListenSession/updateListenStatsTick/finalizeListenSession 之间的循环调用。社区已提交修复 PR。
单体文件(Issue #142):public/index.html 是一个 26000+ 行的单体文件,混合了 CSS、HTML 和 JS。社区提议拆分成模块。
七、为什么值得关注
Mineradio 的价值不在于”又一个音乐播放器”,而在于它重新定义了桌面音乐播放的体验。
传统播放器的核心是”播放音频”,Mineradio 的核心是”创造氛围”。天气电台、粒子视觉、电影镜头运镜——这些功能不是噱头,而是让听歌变成一种沉浸式的感官体验。
对开发者来说:
- GPL-3.0 开源,可以自由修改和二次开发
- Electron + GSAP + WebGL,前端技术栈主流
- 双音乐平台,网易云和 QQ 音乐都支持
- 活跃社区,145+ issues、338 forks、多个衍生项目
- 仅一个月就 4.5k 星,增长势头强劲
相关链接:
- 标题: Mineradio:4.5k 星的沉浸式电影感音乐播放器,天气电台+粒子视觉
- 作者: Seven
- 创建于 : 2026-06-29 10:00:00
- 更新于 : 2026-07-14 00:18:15
- 链接: https://blog.oneiseven.top/2026/06/29/Mineradio-沉浸式电影感音乐播放器/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。