想在终端管理音乐库？Spotatui 把 Spotify 与本地曲库放进同一个播放器
终端音乐播放器通常很轻，但来源单一；桌面流媒体应用功能完整，却未必适合键盘党或自动化工作流。Spotatui 是一个以 Rust 编写的社区播放器项目，既提供终端界面，也有桌面应用预览，并将 Spotify、文件、网络电台等不同来源纳入统一的播放体验。它值得关注的地方不只是“在终端听歌”，更是把多来源播放、可配置界面和 Agent 控制接口组合到一个本地工具里。
它与传统 Spotify TUI 有何不同
Spotatui 是 spotify-tui 的社区维护分支，项目说明其后续已在多个方面分化。传统 spotify-tui 的 Spotify 播放需要外部 Connect 设备；Spotatui 则提供原生 Spotify 流媒体客户端，同时还支持本地文件、Subsonic/Navidrome、网络电台、YouTube、Qobuz，以及 macOS 上的 Apple Music。Spotify 是可选来源：不登录 Spotify，也可以使用其他已支持的来源。
Spotify 的原生播放需要 Premium 账户；项目文档还说明可不注册 Spotify 开发者应用或填写 client ID。非 Spotify 来源则通过 Spotatui 自己的音频引擎播放。需要注意，各来源的可用性与构建方式有关：官方预编译版本包含额外来源；自行从源码编译时，需按文档启用相应 Cargo features。不要把“支持某来源”误解为每一种发行包都必然带有该功能。
安装与首次运行
项目提供多种安装途径。macOS、Linux、WSL 可使用安装脚本，macOS 也可通过 Homebrew；Rust 用户可以从 crates.io 安装：
cargo install --locked spotatui
首次启动后，按界面提示选择音乐来源。若选择 Spotify，按提示在浏览器完成配对登录；若想先试用而不登录，可选择本地文件、网络电台或其他已配置来源。Spotify 播放要求 Premium，而免费来源无需 Spotify 账户。
YouTube 来源依赖外部 yt-dlp（项目建议同时安装 ffmpeg）；从源码构建时启用该来源也需对应 feature。若你使用发行版二进制，应先核对它包含的来源，而不要仅凭 README 的总功能列表推断当前二进制能力。桌面版在 Linux 上另有 WebKitGTK 等系统依赖，官方安装说明列有平台要求；遇到空白窗口或音频设备问题，优先按安装文档排查依赖与后端。
终端操作与个性化
Spotatui 的 TUI 以键盘操作为中心，界面可在不同音乐来源间切换，搜索与侧栏内容随当前来源变化。项目还提供实时音频可视化、播放历史以及 Lua 插件能力；插件可响应播放事件、添加命令或按键、绘制界面组件。配置文件位于 XDG 配置目录下的 spotatui/config.yml，也可以从应用内设置界面修改按键、主题、布局和启动行为。完整键位和配置项以项目文档为准，建议先通过应用内设置查看当前版本的实际映射。
对于常用曲库，可以把配置与状态文件纳入自己的备份方案；涉及凭据时则应谨慎。项目文档明确建议 Subsonic 密码通过 SPOTATUI_SUBSONIC_PASSWORD 环境变量提供，避免以明文留在配置文件中。不要把包含令牌、密码或登录状态的配置文件提交到公开仓库。
让编码 Agent 帮你选歌
Spotatui 还提供可选的 MCP 服务端功能：启用 mcp-server feature 后，终端程序可以通过 MCP 暴露播放器与聆听历史相关工具，供支持 MCP 的客户端调用。项目 README 给出的构建命令为：
cargo install --locked spotatui --features mcp-server
这里的边界很重要：MCP 服务端属于可选构建功能，不代表任何安装包默认都已启用；客户端也必须配置对应 MCP 服务。项目还描述了 ai-dj 功能，可在 TUI 中使用 AI 辅助队列，但这是另一项可选 feature，与 MCP 接口不要混为一谈。若要让 Agent 控制真实播放器，建议先确认工具权限、播放来源和客户端授权范围，再开放会改变播放状态的操作。
适合谁，不适合谁
如果你喜欢终端工作流、希望在多个音乐来源间切换，或想研究本地播放器如何接入 MCP，Spotatui 提供了值得试用的组合。MIT 许可证、Rust 实现和公开配置文档也便于开发者检查与参与。反过来，如果你只需要 Spotify 官方客户端的完整体验，或不希望自行处理音频后端、第三方来源依赖和桌面运行库，直接使用官方应用可能更省心。Spotatui 是社区项目，不应被当作 Spotify 官方软件；使用第三方来源时，也应遵守相应服务的条款。
相关链接