waybar-niri-workspaces - niri workspaces module
NAME DESCRIPTION CONFIGURATION FORMAT REPLACEMENTS ICONS EXAMPLES StyleNAME
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. |