Kwybars：Linux 桌面音频可视化条

项目简介

Kwybars 是一个面向 GNU/Linux（Wayland）的轻量桌面音频可视化工具，用于在屏幕边缘实时渲染音频柱。项目使用 Rust 编写，采用 GPL-3.0 许可证。

0.3.0 版本重写为单一 kwybars 二进制，直接从 PipeWire 采集音频，不再需要 Cava、GTK4、gtk4-layer-shell 和 libnotify。相比旧版，播放时 CPU 占用约降低 20 倍、内存降低约 5 倍，没有音频播放时不做任何工作。

主要功能

• 可视化条可放置在屏幕任意边缘：top | bottom | left | right
• 多显示器支持：仅主屏、全部屏幕或指定屏幕
• 通过 [output.NAME] 段为每台显示器单独配置叠加层和可视化
• 控制窗口图层：background、bottom、top
• 自定义叠加层尺寸与对齐方式
• 纯色或渐变柱色，支持分段柱样式（老式分块风格）
• 多种布局：镜像（mirror）、波形（wave）、径向圆形（radial）、粒子点（particle）、四边画框（frame）、多边形（polygon）
• 透明图片叠加层，可做出 Rainmeter 风格的组合效果
• 有音频时平滑淡入淡出，静音时自动隐藏且不产生唤醒
• 配置文件热重载，无需重启
• 内置主题，也支持 ~/.config/kwybars/themes/*.toml 自定义配色
• 支持分数缩放与运行中显示器热插拔，音频输出切换后自动跟随
• 内置检查命令：kwybars doctor、kwybars validate-config

安装与使用

Arch Linux（AUR）

yay -S kwybars-bin
# 或从源码构建最新 git 提交
yay -S kwybars-git

启动：

kwybars

随会话启动（Hyprland，使用 UWSM 时）：

exec-once = uwsm app -- kwybars

不使用 UWSM 则写 exec-once = kwybars。也可以使用 systemd 用户服务：

systemctl --user enable --now kwybars.service

NixOS

引入 flake 模块并启用：

programs.kwybars.enable = true;

需要用户服务时再设置 programs.kwybars.systemd.enable = true;。也可以直接安装：

nix profile install github:naurissteins/Kwybars#kwybars

Nix Flake

nix build github:naurissteins/Kwybars
./result/bin/kwybars
# 或直接运行
nix run github:naurissteins/Kwybars

屏幕上没有出现可视化条时，运行 kwybars doctor，它会检查配置、合成器、显示器与 PipeWire。

注意事项

• 仅支持 GNU/Linux 的 Wayland 环境。
• 0.3.0 起 kwybars-daemon、kwybars-overlay、kwybarsctl 合并为 kwybars，用户服务名为 kwybars.service；旧配置仍可工作，废弃的键会给出警告或自动映射。
• visualizer.backend 和 pipewire_* 等键已移除，桌面错误通知也已去掉，请查看日志或运行 kwybars doctor。
• 日志文件位于 ~/.local/state/kwybars/kwybars.log。
• 更多说明见官方文档：https://naurissteins.com/kwybars

---

本作品整理自 GitHub 开源项目 naurissteins/Kwybars，原作者 @naurissteins，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。