Skip to content

Latest commit

 

History

History
112 lines (83 loc) · 2.89 KB

waybar-niri-workspaces.5.scd

File metadata and controls

112 lines (83 loc) · 2.89 KB

waybar-niri-workspaces(5)

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.

display-condition: ++ typeof: string ++ oneof: "show-all", "keep-named", "only-populated" ++ default: "show-all" ++ Specifies the conditions for showing workspace widgets. ++ ++ show-all: displays widgets for all workspaces. ++ keep-named: always displays named workspaces, irrespective of whether they contain windows or not. ++ only-populated: only displays widgets for workspaces that have windows.

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.

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.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-: Workspaces named this, or index for unnamed workspaces.