NAME

waybar - niri workspaces module

DESCRIPTION

The workspaces module displays the currently used workspaces in niri.

CONFIGURATION

Addressed by niri/workspaces

all-outputs:
typeof: bool
default: false
If set to false, workspaces will only be shown on the output they are on. If set to true all workspaces will be shown on every output.

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

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

disable-click:
typeof: bool
default: false
If set to false, you can click to change workspace. If set to true this behaviour is disabled.

disable-markup:
typeof: bool
default: false
If set to true, button label will escape pango markup.

current-only:
typeof: bool
default: false
If set to true, only the active or focused workspace will be shown.

on-update:
typeof: string
Command to execute when the module is updated.

expand:
typeof: bool
default: false
Enables this module to consume all left over space dynamically.

FORMAT REPLACEMENTS

{value}: Name of the workspace, or index for unnamed workspaces, as defined by niri.

{name}: Name of the workspace for named workspaces.

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

{index}: Index of the workspace on its output.

{output}: Output where the workspace is located.

ICONS

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

• default: Will be shown, when no string matches are found.
• focused: Will be shown, when workspace is focused.
• active: Will be shown, when workspace is active on its output.
• urgent: Will be shown, when workspace has urgent windows.
• empty: Will be shown, when workspace is empty.

EXAMPLES

"niri/workspaces": {
	"format": "{icon}",
	"format-icons": {
		// Named workspaces
		// (you need to configure them in niri)
		"browser": "",
		"discord": "",
		"chat": "<b></b>",
		// Icons by state
		"active": "",
		"default": ""
	}
}

Style

• #workspaces button
• #workspaces button.focused: The single focused workspace.
• #workspaces button.active: The workspace is active (visible) on its output.
• #workspaces button.urgent: The workspace has one or more urgent windows.
• #workspaces button.empty: The workspace is empty.
• #workspaces button.current_output: The workspace is from the same output as the bar that it is displayed on.
• #workspaces button#niri-workspace-<name>: Workspaces named this, or index for unnamed workspaces.