一款基于 Electron + Vue 3 的第三方网易云音乐桌面播放器
AriesMusic 是一个开源的桌面音乐播放器。应用内置本地化的网易云音乐 API 服务，无需依赖外部在线接口即可使用，并集成音源解析、本地音乐管理、下载、桌面歌词等功能。桌面端（Windows / macOS / Linux）为主，同时适配响应式的移动端 Web 布局。
本项目基于 AlgerMusic 二次开发，遵循 MIT 协议。感谢原作者的开源工作。
前往 Releases 页面，按你的系统下载对应安装包：
| 系统 | 芯片 / 架构 | 安装包 |
|---|---|---|
| macOS | Apple Silicon（M 系列） | AriesMusic-x.x.x-mac-arm64.dmg |
| macOS | Intel | AriesMusic-x.x.x-mac-x64.dmg |
| Windows | x64 | AriesMusic-x.x.x-win-x64.exe |
| Windows | ARM64 | AriesMusic-x.x.x-win-arm64.exe |
| Linux（Debian/Ubuntu） | x64 | AriesMusic-x.x.x-linux-amd64.deb |
| Linux（Debian/Ubuntu） | ARM64 | AriesMusic-x.x.x-linux-arm64.deb |
安装包未做 Apple 代码签名，首次打开会提示「无法验证开发者」或「已损坏」，按需任选一种方式放行：
- 右键点击 App 图标 →「打开」→ 在弹窗里再次点「打开」；或
- 「系统设置 → 隐私与安全性」→ 找到被拦截的 AriesMusic →「仍要打开」；或
- 终端执行去除隔离标记：
xattr -cr /Applications/AriesMusic.app
双击 .exe 按向导安装即可（可自定义安装目录）。若被 SmartScreen 拦截，点「更多信息 →仍要运行」。
sudo dpkg -i AriesMusic-x.x.x-linux-amd64.deb
# 若提示缺少依赖：
sudo apt-get install -f应用为纯离线安装包，不含应用内自动更新。在「设置 →关于」点「检查更新」会与最新版本比对，发现新版时引导你回到 Releases 页手动下载安装。
- 🎵 音乐播放
- 歌单 / MV / 排行榜 / 每日推荐 / 私人 FM / 心动模式
- 播放历史、播放模式（顺序 / 随机 / 单曲 / 心动）
- EQ 均衡器、定时关闭、倍速播放
- 🔐 账号与收藏
- 网易云账号登录（扫码 / UID）
- 「喜欢」红心同步到网易云账号，收藏歌单管理
- 💿 本地音乐
- 导入单个 / 多个音频文件，或添加文件夹批量扫描
- 基于
music-metadata解析封面、时长、内嵌歌词 - 「已下载」与「本地导入」统一管理
- ⬇️ 下载管理
- 单曲 / 批量下载，实时进度、暂停 / 继续 / 取消
- 下载列表与已下载音乐管理
- 🎼 音源解析
- 内置解灰音源（基于
@unblockneteasemusic/server）：QQ / 咪咕 / 酷狗 / 酷我 / pyncmd - GD 音乐台扩展音源，覆盖 netease / joox / bilibili / kuwo / tencent / tidal 等多平台
- 支持导入洛雪音乐（LX Music）音源脚本、自定义 API 音源（见 自定义音源文档）
- 支持 Bilibili 搜索、单曲指定音源
- 内置解灰音源（基于
- 🎤 歌词
- 沉浸式全屏歌词（点击左下角封面进入）
- 独立桌面歌词窗口、逐字歌词
- 🎨 界面与交互
- 明暗主题切换、圆角风格自定义
- 多语言支持（简体中文 / 繁体中文 / English / 日本語 / 한국어）
- 全局 / 应用内快捷键配置
- 系统托盘与状态栏播放控制
| 分类 | 技术 |
|---|---|
| 框架 | Electron 40、Vue 3.5、TypeScript |
| 构建 | electron-vite、Vite 6 |
| UI | Naive UI、TailwindCSS |
| 状态 / 路由 / 国际化 | Pinia、Vue Router、Vue I18n |
| 音乐服务 | netease-cloud-music-api-alger（内置本地服务）、@unblockneteasemusic/server |
环境要求：Node.js 18+，i18n 校验脚本需要 Bun。
# 安装依赖
npm install
# 启动桌面端开发环境
npm run dev
# 仅启动 Web 端开发（浏览器）
npm run dev:webnpm run build # 编译产物
npm run build:win # Windows（nsis 安装包，x64 / arm64）
npm run build:mac # macOS（dmg，Intel + Apple Silicon）
npm run build:linux # Linux（deb，x64 / arm64）npm run lint # ESLint 修复 + i18n 键值校验
npm run typecheck # 主进程 + 渲染进程类型检查
npm run format # Prettier 格式化在「设置 → 播放 → 音乐源」中可导入洛雪音乐（LX Music）音源脚本（.js），扩展可解析的平台。音源由第三方社区维护，可用性会随时间变化，请自行甄别并遵守当地法律法规。以下为社区较活跃的音源汇总仓库：
- xzh767/lxmusic-source-all — 持续更新的洛雪音源汇总
- LuoXiaohei-2025/LX-music-collection — 各版本音源与安装包收集
- Huibq/keep-alive — 洛雪 / MusicFree 保活音源
- pdone/lx-music-source、ZxwyWebSite/lx-source — 自定义解析源
提示：导入的脚本在独立沙箱中执行；若某个源失效，可在音乐源设置里切换其他源或回退到内置解灰音源。
本软件仅用于学习交流，禁止用于任何商业用途，由此产生的一切后果由使用者自行承担。请支持官方正版音乐平台。
本项目基于 MIT 协议开源。