Module: Workspaces

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

Note! It is require compositor to implement ext_workspace_unstable_v1 wayland protocol (which is not merged yet).

Config

option	typeof	default	description
format	string	{name}	The format, how information should be displayed.
format-icons	array		Based on the workspace name and state, the corresponding icon gets selected. See Icons
sort-by-name	bool	true	Should workspaces be sorted by name.
sort-by-coordinates	bool	true	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.
all-outputs	bool	false	If set to false workspaces group will be shown only in assigned output. Otherwise all workspace groups are shown.
active-only	bool	false	If set to true only active or urgent workspaces will be shown.

Format replacements:

string	replacement
{name}	Name of workspace assigned by compositor.
{icon}	Icon, as defined in format-icons.

Icons:

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

port name	note
default	Will be shown, when no string matches is found.
urgent	Will be shown, when workspace is flagged as urgent.
active	Will be shown, when workspace is active

Actions:

string	action
activate	Switch to workspace.
close	Close the workspace.

Example:

"wlr/workspaces": {
  "format": "{icon}",
  "on-click": "activate",
  "format-icons": {
    "1": "",
    "2": "",
    "3": "",
    "4": "",
    "5": "",
    "urgent": "",
    "active": "",
    "default": ""
  }
}

Style

• #workspaces
• #workspaces button
• #workspaces button.focused (use #workspaces button.active if using Hyprland)
• #workspaces button.visible
• #workspaces button.urgent
• #workspaces button.hidden