osfeed.dev
Projects/Alexays / Waybar

Waybar

A configurable status bar for Wayland compositors

by@Alexays·Runs on Linux
Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for 0.16.0 (2026-11-05), so it may lag behind newer releases.

Are you @Alexays?Claim it, and your coding agent keeps it current with each release
0.16.0 · 17 things you can do 12.2k stars 8 changes to know before upgrading

Put a bar on your Wayland desktop with workspaces, clock, battery, audio, network, tray and your own scripts, configured in JSON and styled with CSS.

What you can do with Waybar

Show battery, CPU, memory, disk, temperature, network and Bluetooth status on the bar.

Present at 0.10.0
Share
Wrong?

Show tray icons of running apps such as chat clients and network applets.

Present at 0.10.0
Share
Wrong?

Show the output of your own scripts on the bar, with click and scroll actions.

Present at 0.10.0
Share
Wrong?
Show all 17

Show Mango workspaces, focused window, keyboard language, key mode and layout on the bar.

Since 0.16.0
Good to know

Requires Mango and a build with Mango support.

Share
Wrong?

Show and switch Umbriel workspaces and display the focused window and layout.

Since 0.16.0
Good to know

Requires Umbriel and a build with Umbriel support.

Share
Wrong?

See cellular modem state, carrier, signal quality and connection mode on the bar.

Since 0.16.0
Good to know

Requires ModemManager and a build with `mm-glib`; disconnected modems are hidden by default.

Share
Wrong?

See when applications access location services.

Since 0.16.0
Good to know

Requires GeoClue2 and a build with the privacy module.

Share
Wrong?

Plot values from your own scripts on the bar.

Since 0.16.0
Good to know

Use `custom-graph/<name>` with numeric output or JSON containing `percentage`.

Share
Wrong?

Display multiple images with individual tooltips and click commands in one bar module.

Since 0.16.0
Good to know

Requires image paths or a script producing an array of image entries.

Share
Wrong?

Before you upgrade Waybar

Newest first
Show 5 older
Waybar release history 10
0.16.0

Use Waybar to show Mango workspaces, the focused window and keyboard state.

Correction: The menu-lifetime and callback fixes are in https://github.com/Alexays/Waybar/blob/0.16.0/src/ALabel.cpp; the module-menus change mistakenly cited src/AModule.cpp.

Details

Adds Mango and Umbriel modules, `wwan`, location privacy indicators and custom graphs. Extends workspace, audio and status options and fixes fractional script intervals, tooltips and reconnections.

Also: Umbriel integration, cellular status, location indicators, script graphs, microphone controls and workspace taskbars.

Waybar 0.16.0 for Wayland compositors. Optional integrations require their corresponding services; blur requires compositor support for `ext-background-effect-v1` and wayland-protocols 1.41 at build time.

Added: Show Mango workspaces, focused window, keyboard lan…Added / inferred: Show and switch Umbriel workspaces and display the…Added: See cellular modem state, carrier, signal quality a…Added: See when applications access location services.Added / inferred: Plot values from your own scripts on the bar.Added: Display multiple images with individual tooltips an…Now works / inferred: Show the output of your own scripts on the bar, wit…Improved: Show the output of your own scripts on the bar, wit…Action required / inferred: Show the output of your own scripts on the bar, wit…Improved: Show battery, CPU, memory, disk, temperature, netwo…Behavior changed: Show battery, CPU, memory, disk, temperature, netwo…Now works / inferred: Show battery, CPU, memory, disk, temperature, netwo…Improved: Show battery, CPU, memory, disk, temperature, netwo…Improved: Show and change audio volume from the bar.Now works / inferred: Show and change audio volume from the bar.Improved: Show niri workspaces, the focused window and the ke…Improved: See and switch workspaces or tags, the binding mode…Now works / inferred: See and switch workspaces or tags, the binding mode…Improved: Show the time with a calendar in the tooltip, in se…Now works / inferred: Show the time with a calendar in the tooltip, in se…Improved: Show tray icons of running apps such as chat client…Now works / inferred: Show tray icons of running apps such as chat client…Improved: Show what is playing and control playback of media…Now works / inferred: Show what is playing and control playback of media…Now works / inferred: Open a dropdown menu from a module and run a comman…Improved: Show a bar on one or more screens with the modules…Improved: Show a bar on one or more screens with the modules…Behavior changed: Show a bar on one or more screens with the modules…Now works / inferred: Show a bar on one or more screens with the modules…Action required / inferredAction required / inferredBehavior changed / inferred: Show a bar on one or more screens with the modules…

Seeded by @iluxav with Codex

Read the evidence
0.15.0

Run script modules with intervals under a second.

Details

Script intervals accept millisecond precision. The clock gets an ISO 8601 calendar and timezone-tooltip-format. The layer-shell namespace now follows the bar's name option, so compositors can apply layer rules per bar. Multiple batteries are handled better; dwl/tags gets an empty-tag option.

0.15.0.

Improved: Show the output of your own scripts on the bar, wit…Improved: Show the time with a calendar in the tooltip, in se…Behavior changed / inferred: Show a bar on one or more screens with the modules…

Seeded by @iluxav with Claude Code

Read the evidence
0.14.0

Show workspaces on labwc and other compositors that speak ext-workspace-v1.

Details

wlr/workspaces is replaced by ext/workspaces on the ext-workspace-v1 protocol, with sort-by-number renamed to sort-by-id. hyprland/workspaces gets workspace-taskbar to show window icons per workspace. network gets an rfkill setting, battery emits events at charge levels, and OpenBSD is supported.

0.14.0; ext/workspaces needs wayland-protocols 1.39 or newer at build time.

Action required: See and switch workspaces or tags, the binding mode…Improved: See and switch workspaces or tags, the binding mode…Behavior changed: Show battery, CPU, memory, disk, temperature, netwo…Improved: Show battery, CPU, memory, disk, temperature, netwo…

Seeded by @iluxav with Claude Code

Read the evidence
0.13.0

Show and change microphone volume from the WirePlumber module.

Details

wireplumber gets node-type to control sources such as microphones. New modules: wayfire/window and wayfire/workspaces, gps, hyprland/windowcount. The tray accepts custom icons per app, hyprland/workspaces gets persistent-only, mpris uses mouse back/forward buttons for tracks, niri workspaces show urgency.

Also: systemd-failed-units can show the overall system state; network can show IPv4, IPv6 or both.

0.13.0.

Improved: Show and change audio volume from the bar.Added: Show Wayfire workspaces and the focused window.Improved: Show tray icons of running apps such as chat client…Improved: See and switch workspaces or tags, the binding mode…

Seeded by @iluxav with Claude Code

Read the evidence
0.12.0

Let one module stretch to fill the free space in the bar.

Details

expand on a module and on the module boxes lets them take leftover space, and modules-center can be dropped. backlight gets min-brightness, temperature a warning-threshold, the network module shows IPv4 and IPv6 together, River tags get hide-vacant, hyprland/window gets a tooltip.

0.12.0.

Improved: Show a bar on one or more screens with the modules…Improved: Show battery, CPU, memory, disk, temperature, netwo…

Seeded by @iluxav with Claude Code

Read the evidence
0.11.0

Use Waybar on niri with its workspaces, focused window and keyboard layout.

Details

New niri/workspaces, niri/window and niri/language modules. The image module renders at HiDPI scale, and the CPU module handles offline and hot-plugged CPUs.

0.11.0.

Added: Show niri workspaces, the focused window and the ke…

Seeded by @iluxav with Claude Code

Read the evidence
0.10.4

Open a dropdown menu from any module, such as a power menu with shutdown and reboot.

Details

Modules accept menu, menu-file (a GTK XML file) and menu-actions. Groups get a drawer with click-to-reveal; hide-empty-text hides a module whose output is empty; hyprland/workspaces gets special-visible-only and window-rewrite capture groups; upower can select a device by model; network adds {bssid}.

Also: Bluetooth controller hotplug; a cursor option per module; Hyprland modules are disabled instead of rendered empty when Hyprland is not running.

0.10.4.

Added: Open a dropdown menu from a module and run a comman…Improved: Show the output of your own scripts on the bar, wit…Action required: See and switch workspaces or tags, the binding mode…Behavior changed: See and switch workspaces or tags, the binding mode…

Seeded by @iluxav with Claude Code

Read the evidence
0.10.3

Keep the Hyprland modules working with Hyprland versions that moved their socket to XDG_RUNTIME_DIR.

Details

Hyprland modules look for the socket under $XDG_RUNTIME_DIR/hypr. The cursor changes over clickable modules, tray icons can be styled on hover, and hover applies to whole groups.

0.10.3.

Now works: See and switch workspaces or tags, the binding mode…Improved: Show tray icons of running apps such as chat client…

Seeded by @iluxav with Claude Code

Read the evidence
0.10.2

See your battery's health and charge cycle count on the bar.

Details

battery gains {cycles} and {health} format replacements. hyprland/workspaces gets options for click behavior and active-workspace status and a hosting-monitor CSS class; hyprland/submap gets always-on. Every module can get a :hover style. New dwl/window module. Groups 0.10.1 and 0.10.2.

Also: Calendar shift_reset action; upower warning level; waybar-styles(5) man page.

0.10.2; building the wireplumber module now needs WirePlumber 0.5.

Improved: Show battery, CPU, memory, disk, temperature, netwo…Improved: See and switch workspaces or tags, the binding mode…Action required: Show and change audio volume from the bar.

Seeded by @iluxav with Claude Code

Read the evidence
0.10.0
Starting point

Put a status bar on a Wayland desktop and choose exactly which modules it shows.

Details

State of Waybar at 0.10.0: a layer-shell bar configured in JSON (modules-left, modules-center, modules-right, per output) and styled with CSS, with modules for Sway, River, Hyprland and dwl, tray, clock, battery, UPower, network, Bluetooth, PulseAudio, WirePlumber, disk, memory, CPU, temperature, MPD, MPRIS and custom scripts.

Packaged by most distributions; build with meson and ninja.

Added: Show a bar on one or more screens with the modules…Added: See and switch workspaces or tags, the binding mode…Added: Show battery, CPU, memory, disk, temperature, netwo…Added: Show and change audio volume from the bar.Added: Show tray icons of running apps such as chat client…Added: Show the output of your own scripts on the bar, wit…Added: Show the time with a calendar in the tooltip, in se…Added: Show what is playing and control playback of media…

Seeded by @iluxav with Claude Code

Read the evidence

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky