大约 11 个月前，我重新激活了 spotify-tui 这个优秀但遗憾无人维护的项目。从那以后，我几乎一直在持续开发它，途中发现了很多问题。<p>我遇到的主要问题之一是 Spotify Web API 的速率限制。像 spotatui 这样的第三方客户端依赖于在 Spotify 开发者后台创建的应用，这些应用经常被限流，而 Spotify 也一直在逐步废弃其中的接口。过去的解决方案是使用 ncspot 的共享 client ID，但不幸的是那个也被限流了。于是我开始添加其他播放音源，包括 YouTube、Navidrome/Subsonic、拥有约 30,000 个电台的网络电台、本地文件、提供无损音质的 Qobuz，以及仅限 macOS 上通过远程控制音乐 App 实现的 Apple Music。<p>我用一个方案同时解决了接口废弃和速率限制两个问题。它底层仍然使用 librespot——一个我专门为 spotatui 定制的分支——但不再只是用于播放，而是从中获取所有数据。这些数据来自官方客户端的内部 API，该 API 提供元数据、播放列表、用户音乐库、设备、歌词和音频分析。搜索功能则使用 Pathfinder，即内部的 GraphQL API。<p>由于不存在共享应用配额，因此完全没有 Web API 速率限制。每个用户都使用自己的会话，就像使用官方客户端一样。唯一潜在的问题是 Spotify 没有公开文档记录这个 API，他们那边的任何改动都可能导致功能失效。我打算在问题出现时第一时间修复。<p>它最初在 2019 年是一个 TUI 项目，但从那之后我也为它添加了 GUI。GUI 在功能上目前还稍落后于 TUI，目前只支持 Spotify，但 TUI 和 GUI 之间的完整对等即将实现。之后的目标是与官方客户端功能对等。这也是我把 GUI 设计得几乎和官方客户端一模一样的原因，这样我和用户都更容易发现缺失的功能。<p>Spotatui 还支持 Lua 脚本、spotatui.com 上的可选 Web 伴侣，如果你有 ChatGPT Codex 或 Claude Code 这样的 AI 编程代理，可以启用 MCP 工具，让你只需和 AI 对话就能让它成为你的私人 DJ。<p>它使用 Rust 编写，终端 UI 采用 ratatui，GUI 采用 Tauri 2。Rust 核心会启动一个仅本机可访问的轻量 Web 服务器，GUI 从该服务器加载页面。两个前端共享相同的播放逻辑、登录流程和 Spotify 代码，唯一的区别是交互方式。<p>首次启动时会打开一个网页浏览器，你需要在其中登录 Spotify Premium 账户（Premium 是必需的，不可选），设置就完成了。非常欢迎你反馈遇到的 bug 或希望看到的功能。 GitHub：<a href="https:&#x2F;&#x2F;github.com&#x2F;LargeModGames&#x2F;spotatui" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;LargeModGames&#x2F;spotatui</a> 发布页面：<a href="https:&#x2F;&#x2F;github.com&#x2F;LargeModGames&#x2F;spotatui&#x2F;releases&#x2F;latest" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;LargeModGames&#x2F;spotatui&#x2F;releases&#x2F;latest</a> 官方网站：<a href="https:&#x2F;&#x2F;spotatui.com&#x2F;" rel="nofollow">https:&#x2F;&#x2F;spotatui.com&#x2F;</a><p>感谢 librespot 让这一切成为可能