Spotify Linux 控制

通过 MPRIS DBus 协议控制 Linux 上的 Spotify 桌面客户端——无需浏览器自动化，也无需模拟点击操作。

前提条件

• 已安装 Spotify 桌面客户端（路径为 /opt/spotify/spotify，由 /usr/bin/spotify 封装）
• 处于活跃的 X11/Wayland 会话中，且环境变量 $XAUTHORITY 可用
• 已安装 dbus-send（随 DBus 发行版自带，系统中始终存在）

快速开始

# 暂停/播放切换
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.PlayPause

# 下一首/上一首
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Next
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Previous

1. 启动 Spotify（分离式）

Spotify 必须使用正确的 X11 认证信息启动，并完全脱离代理进程树，以确保 OpenClaw 重启时不会终止 Spotify 进程。

分步操作

# 1. 获取 Xauthority 路径
XAUTHORITY=$(ps aux | grep -E 'Xwayland|Xorg' | grep -oP '-auth \S+' | head -1 | cut -d' ' -f2)

# 2. 使用 setsid 启动（完全分离，可抵御代理进程重启）
DISPLAY=:0 XAUTHORITY="$XAUTHORITY" setsid -f spotify >/dev/null 2>&1

# 3. 等待 DBus 注册完成（Spotify 初始化约需 5–8 秒）
for i in $(seq 1 10); do
  sleep 1
  if dbus-send --session --dest=org.freedesktop.DBus --type=method_call --print-reply 
    /org/freedesktop/DBus org.freedesktop.DBus.ListNames 2>/dev/null | grep -q spotify; then
    break
  fi
done

关键点：setsid -f 将 Spotify 放入独立会话中，使其与启动它的进程树完全解耦。若不使用该方式，仅靠 nohup & 仍会使进程绑定在原会话中，当父会话终止时 Spotify 也会被一并终止。

2. 搜索并播放音轨

MPRIS 规范未定义搜索方法。实现流程为：网络搜索 → 提取 Spotify 音轨 ID → 调用 OpenUri。

# 步骤 1：通过网页搜索获取目标音轨的 Spotify URL
# 示例搜索关键词："李白 李荣浩 spotify"
# 从类似 https://open.spotify.com/track/0aLtafjN146xAdZeqYN8Ho 的 URL 中提取音轨 ID

# 步骤 2：使用 spotify:track: URI 调用 OpenUri
TRACK_ID="0aLtafjN146xAdZeqYN8Ho"
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 
  org.mpris.MediaPlayer2.Player.OpenUri 
  string:"spotify:track:$TRACK_ID"

注意：Spotify 客户端在收到 OpenUri 请求后将立即加载音轨并开始播放——无需额外调用 Play 方法。

支持的 URI 类型：

• spotify:track: — 单首音轨
• spotify:album: — 整张专辑
• spotify:playlist: — 播放列表
• spotify:artist: — 艺人主页

3. 读取播放状态

# 当前播放/暂停状态
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 
  org.freedesktop.DBus.Properties.Get 
  string:org.mpris.MediaPlayer2.Player string:PlaybackStatus

# 当前音轨元数据（标题、艺人、专辑、URL、封面图等）
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 
  org.freedesktop.DBus.Properties.Get 
  string:org.mpris.MediaPlayer2.Player string:Metadata

返回字典中的关键元数据字段：

• xesam:title — 音轨标题
• xesam:artist — 艺人（数组）
• xesam:album — 专辑名称
• xesam:url — Spotify 网页版 URL
• mpris:trackid — 内部音轨 ID 路径
• mpris:artUrl — 专辑封面图 URL

4. 音量控制

# 设置音量（范围：0.0 到 1.0）
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 
  org.freedesktop.DBus.Properties.Set 
  string:org.mpris.MediaPlayer2.Player string:Volume 
  variant:double:0.5

# 读取当前音量
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 
  org.freedesktop.DBus.Properties.Get 
  string:org.mpris.MediaPlayer2.Player string:Volume

5. 检查 Spotify 是否正在运行

# 快速检查：进程是否存在
pgrep -a spotify

# 可靠检查：DBus 检查（确认客户端已完全初始化）
dbus-send --session --dest=org.freedesktop.DBus --type=method_call --print-reply 
  /org/freedesktop/DBus org.freedesktop.DBus.ListNames 2>/dev/null | grep spotify

推荐使用 DBus 检查，因为它能确认客户端已完成初始化并已准备好接收命令；而仅依赖进程检查可能产生误报（例如 Spotify 仍在启动过程中时即被检测为“运行中”）。

6. 播放每日推荐播放列表

“今日推荐” / “每日推荐” 对应 Spotify 的 Daily Mix 系列——每日更新的个性化播放列表。其他推荐播放列表还包括 Discover Weekly 和 Release Radar。

# Daily Mix 1–6（个性化内容，因用户及地区而异）
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 
  org.mpris.MediaPlayer2.Player.OpenUri 
  string:"spotify:playlist:37i9dQZF1E37SmkLuYDrmF"  # Daily Mix 1（中文音乐）

# Discover Weekly（每周新发现）
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 
  org.mpris.MediaPlayer2.Player.OpenUri 
  string:"spotify:playlist:37i9dQZEVXcJZyENOWUFo7"

# Release Radar（新歌雷达）
dbus-send --print-reply --dest=org.mpris.MediaPlayer2.spotify 
  /org/mpris/MediaPlayer2 
  org.mpris.MediaPlayer2.Player.OpenUri 
  string:"spotify:playlist:37i9dQZEVXbhM8yqJpzH4B"

注意：以 37i9dQZF1E37 开头的 Daily Mix URI 是个性化的——同一 URI 对不同用户展示的内容各不相同。搜索结果中显示的内容可能与用户实际听到的内容不一致。

常用 DBus 目标方法