Ubuntu 22.04 安装 GNOME 顶栏歌词扩展教程

本文记录了在 Ubuntu 22.04 (GNOME 42+) 环境下，如何通过开源项目 get_lrc 配合 Executor 扩展，实现在 GNOME 顶栏实时显示歌词的全过程。

1. 前提条件

  • 系统：Ubuntu 22.04 (GNOME 桌面)
  • 播放器：支持 MPRIS 协议的播放器，以 yesplaymusic 为例。

2. 安装必要工具

1
2
3
4
5
sudo apt update
sudo apt install -y \
    gnome-shell-extensions \
    gnome-shell-extension-prefs \
    curl unzip git python3-pip

3. 安装 Go 环境

因为 get_lrc 是 Go 项目，需要先准备 Go 编译环境。

方案 A（推荐）：Snap 安装最新版 Go

1
sudo snap install go --classic

方案 B：APT 安装（版本较旧）

1
sudo apt install -y golang-go

验证：

1
go version

4. 获取并编译 get_lrc

4.1 下载源码

如果直连 GitHub 太慢，可以使用代理或镜像下载。

方法 A：直连（已配置代理）

1
2
git clone https://github.com/MarsSwimmer/get_lrc.git
cd get_lrc

方法 B：镜像下载 zip

1
2
3
4
wget https://ghproxy.com/https://github.com/MarsSwimmer/get_lrc/archive/refs/heads/master.zip -O get_lrc.zip
unzip get_lrc.zip
mv get_lrc-master get_lrc
cd get_lrc

4.2 编译

1
2
go mod tidy
go build -o get_lrc

4.3 安装到系统路径

1
sudo install -m 0755 get_lrc /usr/local/bin/get_lrc

4.4 测试

先确保播放器正在播放歌曲，然后执行：

1
get_lrc

应输出当前歌词。

5. 安装 Executor 扩展

Executor 是一个通用扩展，可以在 GNOME 顶栏显示任意命令的输出。

5.1 通过命令行安装

1
2
3
4
5
gdbus call --session \
  --dest org.gnome.Shell \
  --object-path /org/gnome/Shell \
  --method org.gnome.Shell.Extensions.InstallRemoteExtension \
  'executor@raujonas.github.io'

5.2 启用扩展

1
gnome-extensions enable executor@raujonas.github.io

如果是 Wayland，请注销并重新登录；Xorg 用户可以直接 Alt+F2 → 输入 r → 回车重启 GNOME Shell。

6. 配置 Executor 显示歌词

  1. 打开扩展设置：

    1
    gnome-shell-extension-prefs

    选择 Executor。

  2. 新增一条命令：

    1
    echo "  🎤 $(get_lrc)  "

  3. 设置刷新间隔为 1s ~ 2s。

  4. 可根据需要调整对齐方式、最大宽度等。

7. 效果展示

配置完成后，GNOME 顶栏将实时显示当前播放歌曲的歌词，例如：

1
🎤 We will, we will rock you...

8. 常见问题

  • 没有歌词输出
    → 确认播放器支持 MPRIS，并且正在播放。

  • 顶栏不刷新
    → 检查 Executor 的刷新间隔设置；Wayland 下请注销并重新登录。

  • 歌词过长溢出
    → 在 Executor 设置里限制最大宽度，或用 awk/head 截断输出，例如：

    1
    get_lrc | awk '{print " 🎤 "$0" "}' | head -n1

参考链接