waybar-mango-language(5)

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

NAME

waybar - mango language module

DESCRIPTION

The language module displays the currently active keyboard layout in the Mango compositor.

CONFIGURATION

Addressed by mango/language

format:
typeof: string
default: {}
The format, how the layout should be displayed. See FORMAT REPLACEMENTS.

format-<lang>:
typeof: string
Provide an alternative format string for a given language.

<lang> is the short description of the layout (e.g. "us", "de"). The value is used as the replacement for {} in the main format. This option can be repeated for multiple languages.

format-<lang>-<variant>:
typeof: string
Like format-<lang> but also matches the layout variant, taking precedence over format-<lang> when both the language and variant match.

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

menu-file:
typeof: string
Location of the menu descriptor file. It must contain an element of type GtkMenu with id menu.

menu-actions:
typeof: array
Actions corresponding to the buttons of the menu.

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

FORMAT REPLACEMENTS

{short}: Short name of the layout (e.g. "us").

{shortDescription}: Short description of the layout (same as {short} in most cases).

{long}: Full name of the layout as reported by Mango (e.g. "English (US)"). The empty positional {} in the default format resolves to this value, so the long name is shown when no format is specified.

{variant}: Variant of the layout, if any.

EXAMPLES

"mango/language": {
	"format": " {long} ",
	"format-us": "US",
	"format-de": "DE"
}

STYLE

•
#language

A CSS class matching the current layout's short name is added to the widget. This allows per‑layout styling:

#language.us { color: #00ff00; }
#language.de { color: #ff0000; }
2026-11-06