macOS 上安装 Spotube——DMG 与 Homebrew 两条路

系统要求

• macOS 11 Big Sur 或更高（支持 Intel 和 Apple Silicon 通用二进制）
• 磁盘空间：约 200MB
• 内存：2GB 以上

方式一：DMG 拖拽安装

GitHub Release 提供 Spotube-macos-universal.dmg，一个 DMG 同时支持 Intel 和 Apple Silicon：

1. 双击 DMG 文件挂载镜像
2. 在打开的 Finder 窗口里，把 Spotube 图标拖到 Applications 文件夹
3. 第一次启动：右键 Spotube → 打开（或双击后在弹窗里点"打开"），绕过 Gatekeeper
4. 之后可直接从启动台或 Spotlight 打开

方式二：Homebrew cask

如果你已经装了 Homebrew（macOS 事实上的包管理器）：

brew tap krtirtho/apps
brew install --cask spotube

更新：brew upgrade --cask spotube

卸载：brew uninstall --cask spotube

Apple Silicon 说明

Spotube 官方提供 universal DMG，Apple Silicon 用户不需要 Rosetta 2 就能原生运行。Homebrew cask 也会自动识别芯片架构。

常见问题

Gatekeeper 拦截

第一次打开时 macOS 可能提示"无法打开，因为无法验证开发者"。解决方案：

• 右键 Spotube → 打开 → 在弹窗里点"打开"
• 或系统设置 → 隐私与安全性 → 点底部"仍要打开"

音频不播放

macOS 上 MPV 引擎需要音频输出权限。如果安装后无声音：

1. 系统设置 → 隐私与安全性 → 麦克风（Spotube 不需要，但有时音频权限会绑在一起）
2. Spotube 设置 → 播放引擎 → 确认 MPV 已选中
3. 重启 Spotube

命令行启动

从 Spotlight 或 Finder 打开的 Spotube 是 GUI 应用。如果你想从终端启动（看日志输出）：

open -a Spotube