桌面版下载与安装——Electron 跨平台客户端

仓库与版本

MusicFree 的桌面版有独立的 GitHub 仓库（maotoumao/MusicFreeDesktop），与移动端的仓库分开维护。下载和版本更新都在这个仓库的 Release 页进行。

Windows 安装

Windows 用户有两种选择：

• .exe 安装包：双击运行，按向导完成安装，自动创建桌面快捷方式。
• 便携版：解压即可运行，不写入注册表，适合 U 盘随身携带或多电脑使用。

如果从 GitHub 下载时遇到网络问题，可以尝试换成 GitCode 镜像仓库的 Release 页。

macOS 安装

macOS 提供 .dmg 安装镜像：

1. 双击 .dmg 文件打开挂载窗口。
2. 将 MusicFree 图标拖拽到「应用程序」文件夹。
3. 首次打开时如果系统提示"无法验证开发者"，右键点击应用 → 选择「打开」→ 在弹窗中点「打开」确认。
4. 支持 Apple Silicon（M 系列芯片）和 Intel 芯片，通常有两个独立的安装包可选。

Linux 安装

Linux 提供多种格式的安装包：

• .deb：Debian / Ubuntu / Linux Mint 等发行版，用 dpkg -i 或 apt install 安装。
• .rpm：Fedora / CentOS / openSUSE 等发行版，用 rpm -ivh 或 dnf install 安装。
• .AppImage：通用格式，任何 Linux 发行版都能用，赋予执行权限后双击即可运行，无需安装。

安装后第一步

和移动端一样，首次打开桌面版后同样需要先安装插件。插件安装的界面和流程与移动端基本一致——侧边栏 → 插件设置 → 加号 → 从网络或本地安装。桌面版的优势是界面更大，管理多个插件时比移动端更方便。

桌面版特色

基于 Electron 的桌面版相比移动端有一些天然优势：

• 更大的操作面板：侧边栏、播放列表、歌词可以更宽敞地展示。
• 系统级播放控制：在 Windows / macOS 的系统媒体控制中心可以操作播放暂停、切歌。
• 键盘快捷键：支持播放控制、搜索、窗口最小化等常用操作的全局快捷键。
• 文件拖拽：可以直接把本地音频文件拖入窗口播放。