在mylinuxforwork/dotfiles项目中实现Waybar媒体播放器模块

背景介绍

Waybar作为现代Linux桌面环境中流行的状态栏工具，经常需要扩展其功能以满足用户需求。在mylinuxforwork/dotfiles项目中，用户提出了为Waybar添加媒体播放控制模块的需求，特别是针对Spotify等音乐播放器的集成控制。

技术实现方案

核心组件

1. 模块配置：通过JSON格式定义Waybar的自定义模块
2. Bash脚本：用于获取播放器状态和元数据
3. CSS样式：定制模块的外观显示

详细实现步骤

1. 模块配置

在Waybar的配置文件中添加以下JSON配置段：

"custom/spotify": {
    "exec": "~/.config/waybar/scripts/get_spotify_status.sh",
    "interval": 5,
    "return-type": "json",
    "on-click": "exec playerctl --player=spotify play-pause",
    "on-scroll-up": "exec playerctl --player=spotify next",
    "on-scroll-down": "exec playerctl --player=spotify previous"
}

这段配置定义了：

• 执行脚本路径
• 5秒的刷新间隔
• JSON返回格式
• 点击和滚轮的交互行为

2. Bash脚本实现

创建get_spotify_status.sh脚本文件：

#!/bin/bash

PLAYER="spotify"
FORMAT="{{ artist }} - {{ title }}"
STATUS=$(playerctl --player=$PLAYER status 2>/dev/null)

if [ "$STATUS" = "Playing" ]; then
    TRACK_INFO=$(playerctl --player=$PLAYER metadata --format "$FORMAT")
    echo "{\"text\":\"  $TRACK_INFO\", \"tooltip\":\"Playing\", \"class\":\"playing\"}"
elif [ "$STATUS" = "Paused" ]; then
    TRACK_INFO=$(playerctl --player=$PLAYER metadata --format "$FORMAT")
    echo "{\"text\":\"  $TRACK_INFO\", \"tooltip\":\"Paused\", \"class\":\"paused\"}"
else
    echo "{\"text\":\"  No music is playing\", \"tooltip\":\"Stopped\"}"
fi

脚本功能：

• 检测Spotify播放状态
• 获取当前播放曲目信息
• 输出JSON格式的状态信息

3. CSS样式定制

在Waybar的样式文件中添加：

#custom-spotify {
    font-family: JetBrainsMono Nerd;
    font-size: 14px;
    padding: 0 10px;
}

#custom-spotify .icon {
    padding: 2px;
    margin-right: 5px;
}

#custom-spotify .icon:hover {
    background-color: rgba(255, 255, 255, 0.1);
    border-radius: 4px;
}

常见问题解决

1. 模块不显示：

   • 确保脚本文件具有可执行权限：chmod +x get_spotify_status.sh
   • 检查JSON配置中的逗号分隔符是否正确
   • 确认模块名称已添加到Waybar的模块列表中

2. 功能异常：

   • 确保已安装playerctl工具
   • 检查Spotify是否正在运行
   • 验证脚本路径是否正确

扩展应用

此方案不仅适用于Spotify，通过修改PLAYER变量，可以适配其他兼容MPRIS协议的媒体播放器，如：

• VLC
• Firefox媒体播放
• Chrome浏览器中的YouTube等

总结

通过这个实现，用户可以在Waybar上获得类似KDE Plasma的媒体控制体验，包括：

• 当前播放信息显示
• 播放/暂停控制
• 上一曲/下一曲切换
• 状态可视化反馈

该方案已被正式整合到mylinuxforwork/dotfiles项目的swaync组件中，为用户提供了更加完善的媒体控制体验。