Linux 上安装 Spotube——Flatpak / deb / rpm / tarball 四种方式

系统要求

• 64 位 Linux 发行版
• libGL 或 libEGL（Flutter 需要）
• MPV 或系统音频库（PulseAudio / PipeWire）
• Wayland 和 X11 都支持

方式一：Flatpak（最推荐）

Flatpak 提供了跨发行版的统一安装体验，Spotube 在 Flathub 上架：

flatpak install com.github.KRTirtho.Spotube

或用图形化工具（GNOME Software、KDE Discover）搜索 Spotube。

运行：flatpak run com.github.KRTirtho.Spotube

更新：flatpak update com.github.KRTirtho.Spotube

Flatpak 会自动拉取 MPV、media_kit 等依赖，不需要额外装东西。

方式二：deb 包（Debian / Ubuntu）

GitHub Release 提供 Spotube-linux-x86_64.deb：

sudo apt install ./Spotube-linux-x86_64.deb

卸载：sudo apt remove spotube

方式三：rpm 包（Fedora / OpenSuse）

# Fedora / RHEL / CentOS Stream
sudo dnf install ./Spotube-linux-x86_64.rpm

# OpenSuse
sudo zypper in ./Spotube-linux-x86_64.rpm

方式四：tarball（通用 / 源码编译）

GitHub Release 也提供 Spotube-linux-x86_64.tar.gz，解压后直接运行：

tar xzf Spotube-linux-x86_64.tar.gz
cd spotube
./spotube

AUR（Arch / Manjaro）

# pamac（推荐）
sudo pamac install spotube-bin

# yay
yay -Sy spotube-bin

为什么 AppImage 暂时下线

README 里明确写了 "AppImage's lacking stability led to it's temporary removal"。Issue #1082 记录了这个决定——AppImage 在部分发行版上的沙箱行为和 Flutter 应用有冲突，导致音频播放异常和插件加载失败。作者选择先暂停 AppImage 发行，等 MPV 和 Flutter 侧的问题解决后再恢复。

桌面集成

Flatpak 和 deb/rpm 安装后会自动生成 .desktop 文件，出现在应用菜单里。tarball 方式需要手动创建：

# 示例 ~/.local/share/applications/spotube.desktop
[Desktop Entry]
Type=Application
Name=Spotube
Exec=/path/to/spotube
Icon=/path/to/icon.png
Categories=AudioVideo;Audio;Player;Music;