Repolode
Submit
Alexays

Alexays/Waybar

A highly customizable status bar for Wayland compositors such as Sway, Hyprland and river, with modules for system, network and audio status.

View on GitHub
Stars
12,134
Forks
1,203
Open issues
716
Last commit
13 hours ago

What is it?

Waybar is a status bar for Wayland desktops built on Sway and wlroots-based compositors. It displays workspaces, the focused window, and system information such as battery, CPU, memory, network, audio and the system tray, and each element is a configurable module.

Integration covers Sway, River, Hyprland, Niri, Mango, DWL, Wayfire and Umbriel, with workspace and window support varying by compositor. Modules are configured through a JSON file and styled with CSS, and custom scripts can feed any text or status into the bar.

The project is written in C++ and built with Meson. It is packaged by most Linux distributions, and a default config is included for starting from a working setup.

Key features

  • 01Workspace and window modules for Sway, Hyprland, River, Niri and other compositors.
  • 02Built-in modules for battery, CPU, memory, network, Bluetooth and audio.
  • 03System tray and clock/calendar support.
  • 04Configuration in JSON and styling with CSS.
  • 05Custom script modules for showing arbitrary output in the bar.

Use cases

  • Adding a system status bar to a tiling Wayland setup running Sway or Hyprland.
  • Showing battery, network and audio status on a laptop running a wlroots compositor.
  • Displaying custom script output, such as build or service status, in the bar.

Quick start

  1. 1

    Clone the repository

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

    Enter the project directory

    cd Waybar
  3. 3

    Configure the build with Meson

    meson setup build
  4. 4

    Compile and run Waybar without installing

    ninja -C build && ./build/waybar

Things to know

  • Requires a Wayland compositor such as Sway, Hyprland or river; it does not run on X11.
  • Building from source needs many runtime and build dependencies, such as gtkmm3 and wayland-protocols.

In collections

Desktop GUI apps & toolkits

Topics

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

FAQ

What is Waybar?
A highly customizable status bar for Wayland compositors such as Sway, Hyprland and river, with modules for system, network and audio status. Waybar is a status bar for Wayland desktops built on Sway and wlroots-based compositors. It displays workspaces, the focused window, and system information such as battery, CPU, memory, network, audio and the system tray, and each element is a configurable module.
Is Waybar free to use? What license does it have?
Waybar is open source under the MIT license. Check the license terms before using it in commercial products.
Is Waybar still maintained?
Actively maintained. The last commit to Waybar was on Nov 6, 2026.
What can I use Waybar for?
Adding a system status bar to a tiling Wayland setup running Sway or Hyprland. Showing battery, network and audio status on a laptop running a wlroots compositor. Displaying custom script output, such as build or service status, in the bar.
How do I install Waybar?
Clone the repository: git clone https://github.com/Alexays/Waybar Enter the project directory: cd Waybar Configure the build with Meson: meson setup build Compile and run Waybar without installing: ninja -C build && ./build/waybar
Where can I get Waybar?
The source code and installation instructions are on GitHub: https://github.com/Alexays/Waybar

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects