XxHuberrr/Mineradio · 上手攻略

• 仓库：XxHuberrr/Mineradio
• 链接：https://github.com/XxHuberrr/Mineradio
• 分类：multimedia · music-player
• 作者：Jay
• 更新：2026-07-05

这是什么

Mineradio 是一款面向 Windows 的沉浸式桌面音乐播放器，核心特色是将电影镜头语言、粒子视觉特效和歌词舞台整合在一起，创造接近现场演出的私人音乐空间。定位介于功能播放器与视听艺术装置之间——不只是听歌，是「看」音乐。

当前版本 v1.1.1（2026 年），基于 Electron 开发，支持网易云音乐和 QQ 音乐账号接入。

解决什么问题

• 现有音乐播放器（Spotify、网易云桌面端）以功能为主，缺乏沉浸式视觉体验
• 想在桌面环境获得接近演唱会 VJ 的视听同步体验
• 需要用音乐辅助专注/氛围场景，但不想盯着普通播放列表
• 喜欢歌词视觉化呈现和粒子舞台效果

快速安装

方式一：蓝奏云下载（国内推荐，速度更快）

直接访问蓝奏云链接，下载 Mineradio-1.1.1-Setup.exe：

https://xxhuber.lanzout.com/s/Mineradio

这是国内用户首选，绕过 GitHub Release 在国内的访问速度问题。

方式二：GitHub Release（国际用户备选）

https://github.com/XxHuberrr/Mineradio/releases/tag/v1.1.1

下载 Mineradio-1.1.1-Setup.exe，不要下载 Source code、.blockmap 或 win-unpacked 目录。

安装注意事项

Mineradio 是 Electron 桌面软件，未经代码签名，安装时可能出现以下提示，均为正常现象，按以下步骤处理：

1. 浏览器下载栏提示风险 → 打开下载列表 → 点该条右侧 ... → 选「保留」或「仍要保留」
2. Windows SmartScreen 弹出蓝色拦截 → 点「更多信息」→ 点「仍要运行」
3. 杀毒软件拦截 → 先确认文件来自蓝奏云或 GitHub Release 官方入口 → 文件名为 Mineradio-1.1.1-Setup.exe → 若确认来源正确可放行

⚠️ 安全提示：v1.0.10 及更早旧安装包不再建议使用，请使用 v1.1.1 纯净安装。已安装旧版的建议先卸载、隔离旧安装包后再装新版。

核心功能

🎵 音乐源接入

支持两个平台账号登录，可跨平台搜索和播放，以弥补单一平台版权不足。

🌤️ 天气电台

接入 Open-Meteo 天气 API，根据用户当前位置、城市和天气 mood 自动生成更契合氛围的播放队列。例如晴天推荐偏暖/活力曲目，雨天推荐偏沉静/忧郁的曲目。

🎬 电影镜头视觉系统

Mineradio 的核心特色——基于节拍分析的电影镜头语言。系统会分析当前播放音乐的节拍和情绪，在屏幕上呈现对应的视觉运动，包括： - 镜头推拉 - 舞台灯光效果 - 节奏同步的粒子爆发 - 面向 DJ 曲目和长播客的专属视觉模式

🎤 歌词舞台

• 歌词逐行高亮显示（类似卡拉 OK）
• 支持自定义歌词文件导入
• 歌词位置可调（舞台上方/中央/下方）
• 歌词与粒子舞台同步联动

📦 3D 歌单架

右键唤出 3D 歌单架视图，可直观浏览和管理当前播放队列，支持拖拽排序。

🖼️ 视觉定制

• 自定义专辑封面上传与裁剪
• 内置「默认测试」视觉参数存档（首次启动时使用）
• 银河壁纸（未播放状态保持干净星河氛围）
• Emily / 默认播放态视觉预设

⬆️ 自动更新

应用会检测 GitHub Releases，版本高于本地时自动提示下载。用户也可通过设置中的更新入口手动下载。

典型使用场景

沉浸式听歌（独处时光）

配合耳机或音箱，开启电影镜头模式，把播放器当作音乐可视化背景，适合专注工作或放松休息。

氛围布置

天气电台 + 粒子视觉，适合作为直播背景、读书角背景音或睡前听歌。

DJ/电子音乐爱好者

专用视觉模式专门面向 DJ 曲目和长播客，节拍分析让电子乐的视觉体验更强烈。

网易云 / QQ 音乐账号持有者

直接登录现有账号，同步自己的歌单，无需重新建立音乐库。

坑与注意

1. 版权声明：Mineradio 不是网易云音乐、QQ 音乐或腾讯音乐娱乐集团的官方客户端，也不隶属任何音乐平台。接入仅用于个人本地体验，请遵守各平台用户协议，不要用于商业分发或绕过付费内容。

2. Windows 专属：目前仅提供 Windows 安装包，macOS 和 Linux 用户暂时无法使用。

3. 安装包安全提示：未签名的 Electron 安装包被 Windows Defender / SmartScreen 拦截是常态，不代表软件有问题，只要确认来源是蓝奏云或 GitHub Release 官方入口即可。

4. 隐私提醒：登录 Cookie、搜索历史、自定义封面、歌词文件等数据仅保存在本机用户目录，不要提交到 GitHub 等公共仓库。

5. 版本迭代较快：项目活跃，视觉参数和功能在持续迭代，首次安装建议使用最新 release 版。

6. win-unpacked 不是安装包：不要直接使用 win-unpacked 目录里的 exe 作为正式分发，应该用 Setup.exe 安装器。

与同类对比

Mineradio 的差异化在于沉浸式视听体验，而非功能本身——如果你更在意播放效率和跨平台，推荐 YesPlayMusic；如果你追求视听一体化的仪式感，Mineradio 是目前 Windows 上最独特的选择。

一句话结论

Mineradio 是一款将音乐播放器做成「视听现场」的 Windows 桌面应用，适合追求沉浸感和视觉氛围的用户；网易云+QQ 音乐双接入覆盖大多数中文音乐需求，安装时无视 Windows Defender 提示即可。

Sources: GitHub README (https://github.com/XxHuberrr/Mineradio), v1.1.1 Release Notes, 2026-07-05