Dominique Martinet
632e30eb9f
niri v25.08 added window positions to IPC, so waybar actually has the information stored in json around. This handles the associated WindowLayoutsChanged IPC message to keep the position up to date in memory, and adds a couple of format messages to show the current column, so one can dislpay where we are in the workspace (in the hope of improving this feeling of being lost...) Ideally a visual representation of the workspace like the one illustrated in the PR[1] would be even better but this will probably do for now. Link: https://github.com/YaLTeR/niri/pull/1265#issuecomment-2724621758 [1]
91 lines
2.1 KiB
Scdoc
91 lines
2.1 KiB
Scdoc
waybar-niri-window(5)
|
|
|
|
# NAME
|
|
|
|
waybar - niri window module
|
|
|
|
# DESCRIPTION
|
|
|
|
The *window* module displays the title of the currently focused window in niri.
|
|
|
|
# CONFIGURATION
|
|
|
|
Addressed by *niri/window*
|
|
|
|
*format*: ++
|
|
typeof: string ++
|
|
default: {title} ++
|
|
The format, how information should be displayed. On {} the current window title is displayed.
|
|
|
|
*rewrite*: ++
|
|
typeof: object ++
|
|
Rules to rewrite window title. See *rewrite rules*.
|
|
|
|
*separate-outputs*: ++
|
|
typeof: bool ++
|
|
Show the active window of the monitor the bar belongs to, instead of the focused window.
|
|
|
|
*icon*: ++
|
|
typeof: bool ++
|
|
default: false ++
|
|
Option to hide the application icon.
|
|
|
|
*icon-size*: ++
|
|
typeof: integer ++
|
|
default: 24 ++
|
|
Option to change the size of the application icon.
|
|
|
|
*expand*: ++
|
|
typeof: bool ++
|
|
default: false ++
|
|
Enables this module to consume all left over space dynamically.
|
|
|
|
# FORMAT REPLACEMENTS
|
|
|
|
See the output of "niri msg windows" for examples
|
|
|
|
*{title}*: The current title of the focused window.
|
|
|
|
*{app_id}*: The current app ID of the focused window.
|
|
|
|
*{col}*: The current column of the focused window in the workspace.
|
|
|
|
*{max_col}*: The maximum column inside the workspace of the focused window.
|
|
|
|
# REWRITE RULES
|
|
|
|
*rewrite* is an object where keys are regular expressions and values are
|
|
rewrite rules if the expression matches. Rules may contain references to
|
|
captures of the expression.
|
|
|
|
Regular expression and replacement follow ECMA-script rules.
|
|
|
|
If no expression matches, the title is left unchanged.
|
|
|
|
Invalid expressions (e.g., mismatched parentheses) are skipped.
|
|
|
|
# EXAMPLES
|
|
|
|
```
|
|
"niri/window": {
|
|
"format": "{}",
|
|
"rewrite": {
|
|
"(.*) - Mozilla Firefox": "🌎 $1",
|
|
"(.*) - zsh": "> [$1]"
|
|
}
|
|
}
|
|
```
|
|
|
|
# STYLE
|
|
|
|
- *#window*
|
|
- *window#waybar.empty #window* When no windows are on the workspace
|
|
|
|
The following classes are applied to the entire Waybar rather than just the
|
|
window widget:
|
|
|
|
- *window#waybar.empty* When no windows are in the workspace
|
|
- *window#waybar.solo* When only one window is on the workspace
|
|
- *window#waybar.<app-id>* Where *app-id* is the app ID of the only window on
|
|
the workspace
|