waybar-ext-workspaces - wlr workspaces module

NAME

waybar - wlr workspaces module

The workspaces module displays the currently used workspaces in wayland compositor.

Addressed by ext/workspaces

format:

		typeof: string
		default: {name}
		The format, how information should be displayed.

format-icons:

	typeof: array
	Based on the workspace name and state, the corresponding icon gets selected. See icons.

sort-by-name:

	typeof: bool
	default: true
	Should workspaces be sorted by name. Workspace names will be sorted numerically when all names are numbers.

sort-by-coordinates:

	typeof: bool
	default: false
	Should workspaces be sorted by coordinates.
	Note that if both sort-by-name and sort-by-coordinates are true sort-by name will be first. If both are false - sort by id will be performed.

sort-by-id:

	typeof: bool
	default: false
	Should workspaces be sorted by ID. Workspace ID will be sorted numerically when all ID are numbers. Takes precedence over any other sort-by option.

all-outputs:

	typeof: bool
	default: false
	If set to false workspaces group will be shown only in assigned output. Otherwise, all workspace groups are shown.

active-only:

	typeof: bool
	default: false
	If set to true only active or urgent workspaces will be shown.

ignore-hidden:

	typeof: bool
	default: true
	If set to false hidden workspaces will be shown.

{name}: Name of workspace assigned by compositor.

{id}: ID of workspace assigned by compositor.

{icon}: Icon, as defined in format-icons.

activate: Switch to workspace.

close: Close the workspace.

In addition to workspace name matching, the following format-icons can be set.

	•		default: Will be shown, when no string match is found.
	•		active: Will be shown, when workspace is active

"ext/workspaces": {

}

Updated 2026-06-01 - jenkler.se | uex.se