canido.dev
Use with your agentConnect an agent
Projects/Alexays / Waybar

Waybar

A configurable status bar for Wayland compositors

Get it on GitHub
Unclaimed

Built by @Alexays on GitHub. This page was written by @iluxav from public sources, last updated for 0.15.0 (2026-02-06), and may lag behind new releases.

Maintain Waybar? Claim it
0.15.0 / 2026-02-0611 things you can do6 changes to know before upgradingFollow (Atom feed)

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.

A Waybar bar across the top of a desktop showing workspaces, the focused window title, clock, audio, network, battery and tray icons.

What you can do with it

Show a bar on one or more screens with the modules you choose, configured in JSON and styled with CSS.

Good to know

Needs a compositor with layer-shell; GNOME is not supported.

Present at 0.10.0

See and switch workspaces or tags, the binding mode and the focused window title of your compositor.

Good to know

dwl needs the dwl IPC patch.

Present at 0.10.0

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

Present at 0.10.0

Show and change audio volume from the bar.

Present at 0.10.0

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

Present at 0.10.0

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

Present at 0.10.0

Show the time with a calendar in the tooltip, in several time zones.

Present at 0.10.0

Show what is playing and control playback of media players.

Present at 0.10.0
Show all 11

Open a dropdown menu from a module and run a command for the entry you pick.

Since 0.10.4

Show niri workspaces, the focused window and the keyboard layout.

Since 0.11.0

Show Wayfire workspaces and the focused window.

Since 0.13.0

Before you upgrade

Newest first
0.15.02026-02-06

A bar with a name option gets that name as its layer namespace instead of waybar; compositor layer rules that match waybar must use the name.

Behavior changedInferred
Read the evidence
0.14.02025-08-08

The battery module has a different default tooltip.

Behavior changed
Read the evidence
Show 3 older
0.10.42024-07-17

Rename persistent_workspaces to persistent-workspaces in hyprland/workspaces and sway/workspaces; the underscore spelling is no longer read.

Action requiredAffects: Configs that still use persistent_workspaces
Read the evidence
0.10.42024-07-17

Hyprland modules are disabled when Hyprland's socket is not there, so one config works under both Sway and Hyprland.

Behavior changed
Read the evidence
Release history 9
0.15.02026-02-06

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 (canido)

Read the evidence
0.14.02025-08-08

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 (canido)

Read the evidence
0.13.02025-06-23

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 (canido)

Read the evidence
0.12.02025-02-21

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 (canido)

Read the evidence
0.11.02024-09-13

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 (canido)

Read the evidence
0.10.42024-07-17

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 (canido)

Read the evidence
0.10.32024-05-06

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 (canido)

Read the evidence
0.10.22024-04-23

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 (canido)

Read the evidence
0.10.02024-03-13
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 (canido)

Read the evidence