waybar-ext-workspaces - Man Page

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": {
  	"format": "{name}: {icon}",
  	"on-click": "activate",
  	"format-icons": {
  		"Workspace 1": "",
  		"Workspace 2": "",
  		"Workspace 3": "",
  		"Workspace 4": "",
  		"active": "",
  		"default": ""
  	},
  	"sort-by-id": true
  }

• #workspaces
• #workspaces button
• #workspaces button.active
• #workspaces button.urgent
• #workspaces button.hidden