Waybar

高度可定制的 Wayland 栏，适用于 Sway 和基于 wlroots 的合成器。
可在所有主要发行版中获取。

功能

合成器集成

合成器	工作区 / 标签	窗口	布局	语言	模式
Sway	✅	✅		✅	✅
River	✅	✅	✅		✅
Hyprland	✅	✅		✅	✅
Niri	✅	✅		✅
Mango	✅	✅	✅	✅	✅
DWL	✅	✅
Wayfire	✅	✅

DWL 需要 dwl IPC 补丁。

模块

电源与硬件 — 电池, UPower, 电源配置文件守护进程, 背光, CPU, 内存, 磁盘, 温度
连接性 — 网络, 蓝牙, GPS, WWAN
音频与媒体 — PulseAudio, WirePlumber, JACK, sndio, Cava, MPD, MPRIS
桌面 — 时钟与日历, 系统托盘, 空闲抑制器, 键盘状态, 隐私, Gamemode, Systemd 失败单元, 图像, 自定义脚本

……等等。每个模块都在 wiki 上有文档（参见 Modules 侧边栏）。

入门

git clone https://github.com/Alexays/Waybar
cd Waybar
meson setup build
ninja -C build
./build/waybar          # run without installing

Waybar 启动时带有合理的默认配置。要将其定制为个人使用，请将默认配置和样式表复制到 ~/.config/waybar/ 并进行编辑。配置和样式指南涵盖了所有选项，而示例则提供了可直接使用的社区配置。

安装

Waybar 已被大多数发行版打包：

一个包含更新版本的 Ubuntu PPA 可在此处]获取。

从源码构建

git clone https://github.com/Alexays/Waybar
cd Waybar
meson setup build
ninja -C build
ninja -C build install   # optional

运行时依赖

gtkmm3       jsoncpp      libsigc++    fmt          wayland
chrono-date  spdlog       xkbregistry  libgtk-3-dev upower

libpulse             [Pulseaudio module]
libnl                [Network module]
libappindicator-gtk3 [Tray module]
libdbusmenu-gtk3     [Tray module]
libmpdclient         [MPD module]
libsndio             [sndio module]
libevdev             [KeyboardState module]

构建依赖项

cmake   meson   scdoc   wayland-protocols

安装依赖项 — Ubuntu

sudo apt install \
  clang-tidy gobject-introspection libdbusmenu-gtk3-dev libevdev-dev \
  libfmt-dev libgirepository1.0-dev libgtk-3-dev libgtkmm-3.0-dev \
  libinput-dev libjsoncpp-dev libmpdclient-dev libnl-3-dev libnl-genl-3-dev \
  libpulse-dev libsigc++-2.0-dev libspdlog-dev libwayland-dev scdoc upower \
  libxkbregistry-dev

安装依赖项 — Arch

pacman -S --asdeps \
  gtkmm3 jsoncpp libsigc++ fmt wayland chrono-date spdlog gtk3 \
  gobject-introspection libgirepository libpulse libnl libappindicator-gtk3 \
  libdbusmenu-gtk3 libmpdclient sndio libevdev libxkbcommon upower meson \
  cmake scdoc wayland-protocols glib2-devel

贡献

欢迎贡献 — 请参阅 CONTRIBUTING.md。风格指南是 Google 的 C++ 风格。

文档位于 man 页面中。 模块文档使用 man/ (scdoc) 编写，并自动同步到 wiki。请编辑 man 页面，而非 wiki — 请参阅 .github/wiki。

[!CAUTION] Waybar 的分发包仅在官方 GitHub 页面上发布。
Waybar 没有官方网站。请勿相信任何声称是官方的网站。

许可证

Waybar 采用 MIT 许可证。详见 LICENSE。