NAME¶

waybar - wlr workspaces module

DESCRIPTION¶

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

CONFIGURATION¶

Addressed by wlr/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.

sort-by-coordinates:
typeof: bool
default: true
Should workspaces be sorted by coordinates.

sort-by-number:
typeof: bool
default: false
If set to true, workspace names will be sorted numerically. Takes presedence 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.

FORMAT REPLACEMENTS¶

{name}: Name of workspace assigned by compositor

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

CLICK ACTIONS¶

activate: Switch to workspace.

close: Close the workspace.

ICONS¶

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

EXAMPLES¶

"wlr/workspaces": {
	"format": "{name}: {icon}",
	"format-icons": {
		"1": "",
		"2": "",
		"3": "",
		"4": "",
		"5": "",
		"focused": "",
		"default": ""
	},
	"sort-by-number": true
}

Style¶