|
| 1 | +waybar-niri-workspaces(5) |
| 2 | + |
| 3 | +# NAME |
| 4 | + |
| 5 | +waybar - niri workspaces module |
| 6 | + |
| 7 | +# DESCRIPTION |
| 8 | + |
| 9 | +The *workspaces* module displays the currently used workspaces in niri. |
| 10 | + |
| 11 | +# CONFIGURATION |
| 12 | + |
| 13 | +Addressed by *niri/workspaces* |
| 14 | + |
| 15 | +*all-outputs*: ++ |
| 16 | + typeof: bool ++ |
| 17 | + default: false ++ |
| 18 | + 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. |
| 19 | + |
| 20 | +*format*: ++ |
| 21 | + typeof: string ++ |
| 22 | + default: {value} ++ |
| 23 | + The format, how information should be displayed. |
| 24 | + |
| 25 | +*format-icons*: ++ |
| 26 | + typeof: array ++ |
| 27 | + Based on the workspace name, index and state, the corresponding icon gets selected. See *icons*. |
| 28 | + |
| 29 | +*disable-click*: ++ |
| 30 | + typeof: bool ++ |
| 31 | + default: false ++ |
| 32 | + If set to false, you can click to change workspace. If set to true this behaviour is disabled. |
| 33 | + |
| 34 | +*disable-markup*: ++ |
| 35 | + typeof: bool ++ |
| 36 | + default: false ++ |
| 37 | + If set to true, button label will escape pango markup. |
| 38 | + |
| 39 | +*current-only*: ++ |
| 40 | + typeof: bool ++ |
| 41 | + default: false ++ |
| 42 | + If set to true, only the active or focused workspace will be shown. |
| 43 | + |
| 44 | +*on-update*: ++ |
| 45 | + typeof: string ++ |
| 46 | + Command to execute when the module is updated. |
| 47 | + |
| 48 | +# FORMAT REPLACEMENTS |
| 49 | + |
| 50 | +*{value}*: Name of the workspace, or index for unnamed workspaces, |
| 51 | +as defined by niri. |
| 52 | + |
| 53 | +*{name}*: Name of the workspace for named workspaces. |
| 54 | + |
| 55 | +*{icon}*: Icon, as defined in *format-icons*. |
| 56 | + |
| 57 | +*{index}*: Index of the workspace on its output. |
| 58 | + |
| 59 | +*{output}*: Output where the workspace is located. |
| 60 | + |
| 61 | +# ICONS |
| 62 | + |
| 63 | +Additional to workspace name matching, the following *format-icons* can be set. |
| 64 | + |
| 65 | +- *default*: Will be shown, when no string matches are found. |
| 66 | +- *focused*: Will be shown, when workspace is focused. |
| 67 | +- *active*: Will be shown, when workspace is active on its output. |
| 68 | + |
| 69 | +# EXAMPLES |
| 70 | + |
| 71 | +``` |
| 72 | +"niri/workspaces": { |
| 73 | + "format": "{icon}", |
| 74 | + "format-icons": { |
| 75 | + // Named workspaces |
| 76 | + // (you need to configure them in niri) |
| 77 | + "browser": "", |
| 78 | + "discord": "", |
| 79 | + "chat": "<b></b>", |
| 80 | +
|
| 81 | + // Icons by state |
| 82 | + "active": "", |
| 83 | + "default": "" |
| 84 | + } |
| 85 | +} |
| 86 | +``` |
| 87 | + |
| 88 | +# Style |
| 89 | + |
| 90 | +- *#workspaces button* |
| 91 | +- *#workspaces button.focused*: The single focused workspace. |
| 92 | +- *#workspaces button.active*: The workspace is active (visible) on its output. |
| 93 | +- *#workspaces button.empty*: The workspace is empty. |
| 94 | +- *#workspaces button.current_output*: The workspace is from the same output as |
| 95 | + the bar that it is displayed on. |
| 96 | +- *#workspaces button#niri-workspace-<name>*: Workspaces named this, or index |
| 97 | + for unnamed workspaces. |
0 commit comments