Fastpotify 是什么？
Fastpotify 是一款原生的 Spotify 桌面客户端，用 Rust 和 egui 编写，通过 librespot 播放音乐。整个进程里没有任何浏览器引擎，这正是它的意义所在：启动用时远不到一秒，运行期间也一直很轻，而官方客户端在同一台机器上两样都做不到。它本身就是一台 Spotify Connect 设备，既能在这台电脑上播放，也能控制账号下的其他所有设备。你的整个音乐库都在：播放列表、喜欢的歌曲、收藏的专辑、关注的艺人、播客和单集，还有搜索、艺人页、专辑页、播放列表页、播放队列、均衡器、媒体键和托盘图标。
⚡ Fastpotify 的主要特性
⚡ 原生，而且很小
Rust 加 egui，直接绘制到 GPU。没有 Electron，没有内嵌的 Chromium，也没有 WebView。启动用时远不到一秒，内存占用一直停在起点附近，这才让它在老笔记本或树莓派上真正可用。
🔊 一台 Spotify Connect 设备
通过 librespot 在本机播放，无缝衔接，最高 320 kbps，可选音量归一化和磁盘音频缓存。也可以从手机上选中这台机器。设备选择器能把播放转移到音箱或另一台电脑，并继续在这里控制。
📡 发现局域网里的音箱
网络里待命的 librespot、spotifyd 或硬件接收器，在绑定账号之前对 Spotify 的 API 是不可见的。Fastpotify 通过 mDNS 找到它们并替你连接，之后它们就和其他 Connect 设备一样。
📚 完整的音乐库
播放列表、喜欢的歌曲、收藏的专辑、关注的艺人、播客和已保存的单集，都能在侧边栏里过滤。搜索覆盖所有类型，首页有“为你打造”和最近播放，艺人、专辑、播放列表和播客页都能从任意一行开始播放。
🎛️ Winamp 迷你播放器
Ctrl+M 把窗口缩成经典的迷你播放器，能穿上真正的 .wsz 皮肤，以 1 倍到 4 倍逐像素绘制，下面还挂着频谱分析器、播放列表和十段均衡器。MilkDrop 视觉效果通过 projectM 在独立窗口中运行。
🖥️ 真正的桌面集成
基于 D-Bus 的 MPRIS，媒体键、桌面环境和 playerctl 都能像对待其他播放器一样控制它。关闭窗口就是真的关闭，音乐从托盘继续播放；重复启动只会唤起已有窗口；常用操作都有快捷键。
apt upgrade 就能保持在最新版本。
📦 从 deb.griffo.io 安装
第 1 步：添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 有一个永久免费的镜像。 deb-free.griffo.io 永久免费提供软件包 — 无需账号、无需订阅，最多落后上游 2 个月，安全修复立即发布。目前收录 cliamp、Ghostty、lazydocker、Oh My Posh 和 Zed；Fastpotify 不在其中，因此今天只能通过上面的仓库安装 — 提出请求即可将其加入。
🧩 关于 extrepo 选项。 extrepo 是 Debian 官方用于管理第三方仓库的工具：它会替你写好 sources 文件并安装签名密钥，并在使用前先对照签名元数据校验该密钥。本仓库以 griffo 之名登记其中，永久免费镜像则为 griffo-free，因此在 Debian（bookworm、trixie、forky、sid）上，上面的命令就是全部配置。
extrepo 只负责 sources 文件和密钥，订阅凭据仍然要写入 /etc/apt/auth.conf.d/deb.griffo.io.conf。Ubuntu 不在覆盖范围内，因为 extrepo 只发布 Debian 各套件的元数据：在 Ubuntu 上请使用 sudo 或 root 的命令。
第 2 步：安装 Fastpotify
# 安装最新的 Fastpotify
sudo apt install fastpotify
# 推荐安装，否则非拉丁字母的曲目名会显示成方块
sudo apt install fonts-noto-cjk fonts-noto-core
# 验证安装
fastpotify --version# 安装最新的 Fastpotify
apt install fastpotify
# 推荐安装，否则非拉丁字母的曲目名会显示成方块
apt install fonts-noto-cjk fonts-noto-core
# 验证安装
fastpotify --version第 3 步：第一次运行
# 直接启动，或者从应用菜单里选择 Fastpotify
fastpotify
# 在它打开的浏览器窗口中登录，然后关掉即可。
# 在这台电脑上播放音乐需要 Spotify Premium 账号；
# 免费账号可以浏览音乐库，但不能播放。
# 窗口起来之后按 Ctrl+/ 或 ? 查看所有快捷键🎯 基本使用示例
围绕窗口：
# 启动它，或者唤起已经在运行的那一个
fastpotify
# Ctrl+M 切换到 Winamp 迷你播放器，再按一次切回来
# Ctrl+Q 真正退出，连托盘图标一起
# Ctrl+/ 在一屏之内列出所有快捷键用 MPRIS 从 shell 控制它：
# playerctl 可以像对待其他播放器一样和 Fastpotify 对话
playerctl -p fastpotify play-pause
playerctl -p fastpotify next
playerctl -p fastpotify position 90
# 取出正在播放的内容，交给状态栏
playerctl -p fastpotify metadata --format '{{artist}} - {{title}}'它把东西放在哪里：
# 设置、会话和音频缓存
ls ~/.config/fastpotify
ls ~/.cache/fastpotify
# 软件包安装的桌面入口和图标
ls /usr/share/applications/fastpotify.desktop
ls /usr/share/icons/hicolor/*/apps/fastpotify.png🔧 工具集成
Fastpotify 有意建立在桌面已有的组件之上：
- PulseAudio 与 PipeWire：音频通过会话的声音服务器输出，底层是 ALSA，这也是软件包依赖
libpulse0和libasound2t64的原因 - 基于 D-Bus 的 MPRIS：键盘上的媒体键、桌面的“正在播放”小部件和
playerctl都能像控制其他播放器一样控制它 - 系统托盘：一个状态通知项，关闭窗口后音乐继续播放，点击托盘即可唤回；在 GNOME、KDE 和各种平铺式合成器上表现一致
- Wayland 与 X11：两者都支持，使用系统上常见的客户端库，软件包依赖它们而不是自带副本
- Noto 字体：推荐依赖，负责绘制中文、日文、韩文、阿拉伯文、希伯来文、泰文和印度系文字的曲目名，否则会显示成方块
🚀 为什么选择 deb.griffo.io？
- 官方 Debian：没有打包 Fastpotify，在原始系统上
apt install fastpotify会失败 - cargo install：版本够新，但要在每台机器上从源码构建 libprojectM，因此需要先准备 CMake、C++ 编译器、libclang，以及 ALSA、PulseAudio 和窗口系统的开发头文件
- 上游二进制文件：一个需要你自己安放的文件，位于包管理器之外，没有桌面入口、没有图标，也没有依赖检查
- deb.griffo.io：最新版本，自动更新
- ✅ 唯一的 apt 来源：Fastpotify 既不在 Debian 也不在 Ubuntu 的软件源中；本仓库打包的是官方上游构建
- ✅ 它迭代很快：每周多个版本，Spotify 那边弄坏某个页面的改动会在几天内于上游修好，所以保持最新确实有意义
- ✅ 自动更新：上游发布后数小时内更新软件包
- ✅ 完整的软件包：
/usr/bin/fastpotify、桌面入口和应用图标，因此它会像其他程序一样出现在应用菜单里 - ✅ 诚实的依赖：如实声明 ALSA、PulseAudio、OpenGL、X11 和 Wayland 库，Noto 字体只是推荐依赖，不会被悄悄装上
- ✅ 两种架构：amd64 与 arm64，这也是上游发布的全部 Linux 构建
- ✅ 多发行版：支持 Trixie、Forky 和 Sid
- ✅ 维护简单：使用标准 apt 命令更新
libc6 (>= 2.39)，而 Debian 12 自带的是 glibc 2.36，没有可安装的版本。Trixie、Forky 和 Sid 都没有问题。📦 软件包构建仓库
Debian 软件包在这个 GitHub 仓库中自动构建和维护：
- 🎵 fastpotify-debian - 最新版本构建
🔗 相关软件包
deb.griffo.io 同样提供：
- cliamp - 复古终端音乐播放器，适合不在桌面前的时候
- termusic - 另一款终端音乐与播客播放器，适合本地音乐库
- lowfi - 一条命令即可播放的 lo-fi 电台播放器，适合完全不想要界面的场景
- yt-dlp - 用于那些根本不在 Spotify 上的曲目