Repolode
提交项目
Alexays

Alexays/Waybar

面向 Wayland 合成器（如 Sway、Hyprland）的高度可定制状态栏，内置系统、网络、音频等模块。

在 GitHub 查看
Star
12,134
Fork
1,203
未关闭 Issue
716
最近提交
10小时前

这是什么？

Waybar 是一款面向 Wayland 桌面的状态栏，基于 Sway 及 wlroots 系合成器运行。它可以显示工作区、当前窗口，以及电池、CPU、内存、网络、音频和系统托盘等系统信息，每个元素都是可配置的模块。

它支持 Sway、River、Hyprland、Niri、Mango、DWL、Wayfire 和 Umbriel 等合成器，各合成器下的工作区和窗口功能略有差异。模块通过 JSON 文件配置，外观使用 CSS 设置，也可以通过自定义脚本把任意文本或状态显示到栏上。

项目使用 C++ 编写，采用 Meson 构建，多数 Linux 发行版都有打包，并附带默认配置，便于从可用的状态开始调整。

核心功能

  • 01为 Sway、Hyprland、River、Niri 等合成器提供工作区和窗口模块。
  • 02内置电池、CPU、内存、网络、蓝牙和音频等系统模块。
  • 03支持系统托盘、时钟和日历。
  • 04通过 JSON 配置模块，通过 CSS 设置外观。
  • 05支持自定义脚本模块，可将任意输出显示在栏上。

适用场景

  • 为运行 Sway 或 Hyprland 的平铺式 Wayland 桌面添加系统状态栏。
  • 在使用 wlroots 合成器的笔记本上显示电池、网络和音频状态。
  • 在状态栏中展示自定义脚本输出，例如构建或服务状态。

快速上手

  1. 1

    克隆仓库

    git clone https://github.com/Alexays/Waybar
  2. 2

    进入项目目录

    cd Waybar
  3. 3

    使用 Meson 配置构建

    meson setup build
  4. 4

    编译并无需安装直接运行 Waybar

    ninja -C build && ./build/waybar

使用前须知

  • 需要 Sway、Hyprland 或 river 等 Wayland 合成器，不能在 X11 上运行。
  • 从源码构建需要大量运行时和构建依赖，例如 gtkmm3 和 wayland-protocols。

收录于专题

桌面图形界面应用与框架

标签

#wayland#status-bar#sway#linux#desktop#hyprland#wlroots#bar#gtk#i3status

常见问题

Waybar 是什么？
面向 Wayland 合成器（如 Sway、Hyprland）的高度可定制状态栏，内置系统、网络、音频等模块。 Waybar 是一款面向 Wayland 桌面的状态栏，基于 Sway 及 wlroots 系合成器运行。它可以显示工作区、当前窗口，以及电池、CPU、内存、网络、音频和系统托盘等系统信息，每个元素都是可配置的模块。
Waybar 可以免费使用吗？用的什么许可证？
Waybar 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
Waybar 还在维护吗？
活跃维护中。Waybar 最近一次提交是在 2026年11月6日。
Waybar 适合用来做什么？
为运行 Sway 或 Hyprland 的平铺式 Wayland 桌面添加系统状态栏。 在使用 wlroots 合成器的笔记本上显示电池、网络和音频状态。 在状态栏中展示自定义脚本输出，例如构建或服务状态。
Waybar 怎么安装和运行？
克隆仓库: git clone https://github.com/Alexays/Waybar 进入项目目录: cd Waybar 使用 Meson 配置构建: meson setup build 编译并无需安装直接运行 Waybar: ninja -C build && ./build/waybar
在哪里获取 Waybar？
源代码和安装说明在 GitHub 上：https://github.com/Alexays/Waybar

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目