Spotify Player

适用于无头Linux服务器的Spotify命令行工具。通过终端和Cookie认证控制播放,无需OAuth回调。完美适配无图形界面的远程服务器。

安装

概览

Spotify Player 是一款专为无头 Linux 服务器设计的命令行工具,允许用户通过终端直接控制 Spotify 播放。它采用 Cookie 认证机制,避免了传统 OAuth 流程中必需的本地浏览器回调环节,因此特别适合远程服务器环境使用。该工具完全基于 Go 语言开发,无需图形界面即可运行,只需将两个关键的浏览器 Cookie(sp_dc 和 sp_t)配置到本地文件中即可完成身份验证。Spotify Player 支持播放、暂停、切换曲目等基础操作,并能搜索音乐、管理设备列表,同时提供 JSON 格式输出以满足自动化需求。其核心优势在于不依赖任何 GUI 组件或本地浏览器进程,使得在 SSH 会话或容器化环境中也能流畅操控 Spotify 客户端。

核心功能特点

  1. 基于 Cookie 认证,无需 OAuth 回调即可登录 Spotify
  2. 纯命令行操作,完美适配无图形界面的 Linux 服务器
  3. 支持播放控制(播放/暂停/上一曲/下一曲)
  4. 可搜索曲目并指定播放源设备
  5. 提供 JSON 格式的状态与设备信息输出
  6. 自动处理 Spotify Connect API 调用,兼容 Premium 账户

适用场景

Spotify Player 最典型的应用场景是在没有桌面环境的远程服务器上实现音乐播放控制。例如,运维人员可以通过 SSH 连接到一台仅安装命令行的云服务器,利用该工具在后台播放背景音乐或语音提示,而无需启动 X Window 系统。另一个常见用例是家庭媒体中心或 NAS 设备,这些设备通常运行轻量级 Linux 发行版且无显示器接入,但需要持续播放音乐流。此外,开发者可在 CI/CD 流水线中集成该工具,在构建完成时播放通知音效;或在监控系统中作为告警音输出载体。由于其所有通信均指向 Spotify 官方 API,安全性较高,且不会泄露用户隐私数据,因此也适用于对安全敏感的生产环境。无论是自动化脚本调用还是手动终端操作,Spotify Player 都能提供稳定可靠的体验。