2019-08-26 18:00:46 +01:00
waybar-sway-window(5)
# NAME
waybar - sway window module
# DESCRIPTION
The * window * module displays the title of the currently focused window in Sway
# CONFIGURATION
Addressed by * sway/window *
* format * : ++
typeof: string ++
2022-08-10 22:24:48 +02:00
default: {title} ++
2022-08-11 08:41:10 +02:00
The format, how information should be displayed.
2019-08-26 18:00:46 +01:00
* rotate * : ++
typeof: integer ++
Positive value to rotate the text label.
* max-length * : ++
typeof: integer ++
The maximum length in character the module should display.
2021-02-01 08:34:51 -08:00
* min-length * : ++
typeof: integer ++
The minimum length in characters the module should take up.
* align * : ++
typeof: float ++
The alignment of the text, where 0 is left-aligned and 1 is right-aligned. If the module is rotated, it will follow the flow of the text.
2019-08-26 18:00:46 +01:00
* on-click * : ++
typeof: string ++
Command to execute when clicked on the module.
2019-12-28 20:22:53 -08:00
* on-click-middle * : ++
typeof: string ++
Command to execute when middle-clicked on the module using mousewheel.
2019-08-26 18:00:46 +01:00
* on-click-right * : ++
typeof: string ++
Command to execute when you right clicked on the module.
2020-04-12 18:35:41 +02:00
* on-update * : ++
typeof: string ++
Command to execute when the module is updated.
2019-08-26 18:00:46 +01:00
* on-scroll-up * : ++
typeof: string ++
Command to execute when scrolling up on the module.
* on-scroll-down * : ++
typeof: string ++
Command to execute when scrolling down on the module.
* smooth-scrolling-threshold * : ++
typeof: double ++
Threshold to be used when scrolling.
* tooltip * : ++
typeof: bool ++
default: true ++
Option to disable tooltip on hover.
2022-04-17 07:13:35 +02:00
* all-outputs * : ++
typeof: bool ++
default: false ++
Option to show the focused window along with its workspace styles on all outputs.
* offscreen-css * : ++
typeof: bool ++
default: false ++
Only effective when all-outputs is true. Adds style according to present windows on unfocused outputs instead of showing the focused window and style.
* offscreen-css-text * : ++
typeof: string ++
Only effective when both all-outputs and offscreen-style are true. On screens currently not focused, show the given text along with that workspaces styles.
* show-focused-workspace-name * : ++
typeof: bool ++
default: false ++
If the workspace itself is focused and the workspace contains nodes or floating_nodes, show the workspace name. If not set, text remains empty but styles according to nodes in the workspace are still applied.
2021-04-21 12:18:33 +02:00
*rewrite*: ++
typeof: object ++
Rules to rewrite window title. See *rewrite rules*.
2022-03-07 14:53:53 +01:00
* icon * : ++
typeof: bool ++
2022-03-10 09:49:14 +01:00
default: false ++
2022-03-07 14:53:53 +01:00
Option to hide the application icon.
2022-04-17 23:54:27 +02:00
* icon-size * : ++
typeof: integer ++
default: 24 ++
Option to change the size of the application icon.
2022-08-10 22:24:48 +02:00
# FORMAT REPLACEMENTS
* {title} * : The title of the focused window.
* {app_id} * : The app_id of the focused window.
* {shell} * : The shell of the focused window. It's 'xwayland' when the window is
running through xwayland, otherwise it's 'xdg-shell'.
2021-04-21 12:18:33 +02:00
# 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.
2019-08-26 18:00:46 +01:00
# EXAMPLES
```
"sway/window": {
"format": "{}",
2021-04-21 12:18:33 +02:00
"max-length": 50,
"rewrite": {
"(.*) - Mozilla Firefox": "🌎 $1",
"(.*) - zsh": "> [$1]"
}
2019-08-26 18:00:46 +01:00
}
```
# STYLE
- * #window *
2022-04-17 07:13:35 +02:00
- * window#waybar.empty * When no windows are in the workspace, or screen is not focused and offscreen-text option is not set
- * window#waybar.solo * When one tiled window is in the workspace
- * window#waybar.floating * When there are only floating windows in the workspace
- * window#waybar.stacked * When there is more than one window in the workspace and the workspace layout is stacked
- * window#waybar.tabbed * When there is more than one window in the workspace and the workspace layout is tabbed
- * window#waybar.tiled * When there is more than one window in the workspace and the workspace layout is splith or splitv
2019-08-26 18:00:46 +01:00
- * window#waybar.<app_id> * Where * app_id * is the app_id or * instance * name like (* chromium * ) of the only window in the workspace
