waybar-mango-keymode(5)

waybar-mango-keymode(5) File Formats Manual waybar-mango-keymode(5)

NAME

waybar - mango keymode module

DESCRIPTION

The keymode module displays the current keyboard mode (e.g. "resize", "default") in the Mango compositor. It is hidden when no mode is active.

CONFIGURATION

Addressed by mango/keymode

format:
typeof: string
default: {}
The format, how the mode should be displayed. {mode} is replaced by the current mode name.

format-<mode>:
typeof: string
Provide a custom format for a specific keymode. <mode> is the mode name as reported by Mango (e.g. "resize"). The value can contain {mode} as a placeholder.

If this option is set, it overrides the main format for that mode.

menu:
typeof: string
Action that pops up a menu.

menu-file:
typeof: string
Location of the menu descriptor file.

menu-actions:
typeof: array
Actions for the menu buttons.

expand:
typeof: bool
default: false
Enables the module to consume all leftover space.

FORMAT REPLACEMENTS

{mode}: The name of the current keymode.

EXAMPLES

"mango/keymode": {
	"format": "[{mode}]",
	"format-resize": " Resizing"
}

STYLE

•
#keymode

A CSS class with the current mode name (e.g. .resize) is added to the widget, allowing per‑mode styling:

#keymode.resize { background: #ff0000; }
2026-11-06