spotatui：终端音乐播放器

项目简介

spotatui 是一款用 Rust 编写的终端音乐播放器，同时提供处于预览阶段的桌面版。它源自 spotify-tui 的分支，如今已经拥有自己的播放器、音源与桌面应用。Spotify 只是七种音源之一，并非必需。

Spotify 通过内置客户端登录，无需自行申请开发者应用，也不需要 client ID。

主要功能

• 多音源：Spotify、本地文件、Subsonic / Navidrome、网络电台（来自 radio-browser.info 的 3 万多电台）、YouTube、Qobuz，macOS 上还支持 Apple Music。
• 同步歌词与实时音频可视化。
• 混合播放队列：可以把来自不同音源的曲目放进同一个队列。
• 播放列表同步：把一份播放列表镜像到 Spotify、Qobuz、Subsonic 或 YouTube。
• Lua 插件：可扩展命令、按键、弹窗与主题。
• AI DJ：既可在应用内使用，也可让编码助手通过 MCP 充当 DJ。
• 本地收听历史：带统计信息与可分享的回顾总结。
• 提供 CLI，可在终端中控制播放、搜索和管理播放列表。

安装与使用

系统	命令
macOS、Linux、WSL	curl -fsSL https://spotatui.com/install.sh | bash
Windows	irm https://spotatui.com/install.ps1 | iex 或 winget install spotatui
Arch Linux	yay -S spotatui-bin
已装 Rust	cargo install --locked spotatui

Homebrew、Nix、Void、.deb 安装包以及从源码构建的方式，见安装文档。

桌面应用可从最新发布页下载对应系统的安装包。

运行 spotatui 即可启动。首次启动时会询问你想启用哪些音源；如果选择 Spotify，程序会显示一个配对码并打开 Spotify 配对页面，确认后即可登录。

常用操作：

• ?：列出全部按键。
• /：搜索。用方向键切到 Songs 面板，按 Enter 进入，再按一次 Enter 播放曲目。
• d：切换音源与设备。
• z：加入队列，Shift+Q 打开队列。
• spotatui --help：查看 CLI 用法。

注意事项

• Spotify 需要 Premium 账号；其他音源无需账号即可使用。
• YouTube 音源需要 PATH 中有 yt-dlp；Apple Music 需要 macOS 与「音乐」应用；Subsonic / Navidrome 与 Qobuz 需要对应的账号。
• 本地文件、Subsonic、网络电台、YouTube、Qobuz 由 spotatui 自己的音频引擎播放；Apple Music 则在「音乐」应用中播放，spotatui 只做遥控。
• 预编译的终端二进制包含全部音源、MCP 服务与 AI DJ；cargo install 默认只带 Spotify，需要自行添加特性（feature），Nix flake 同样只构建 Spotify。
• 终端应用会自动更新；若由包管理器安装，可设置 behavior.disable_auto_update: true 关闭。

---

本作品整理自 GitHub 开源项目 LargeModGames/spotatui，原作者 @LargeModGames，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。