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

# [NAME](#NAME)

waybar - hyprland language module

# [DESCRIPTION](#DESCRIPTION)

The **language** module displays the currently selected language.

# [CONFIGURATION](#CONFIGURATION)

Addressed by **hyprland/language**

**format**:  
typeof: string  
default: {}  
The format, how information should be displayed.

**format-<lang>**  
typeof: string  
Provide an alternative name to display per language where <lang> is the language of your choosing. Can be passed multiple times with multiple languages as shown by the example below.

**keyboard-name**:  
typeof: string  
Specifies which keyboard to use from hyprctl devices output. Using the option that begins with "at-translated-set..." is recommended.

**menu**:  
typeof: string  
Action that popups the menu.

**menu-file**:  
typeof: string  
Location of the menu descriptor file. There need to be an element of type

GtkMenu with id **menu**

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

**expand**:  
typeof: bool  
default: false  
Enables this module to consume all left over space dynamically.

# [FORMAT REPLACEMENTS](#FORMAT_REPLACEMENTS)

**{short}**: Short name of layout (e.g. "us"). Equals to {}.

**{shortDescription}**: Short description of layout (e.g. "en").

**{long}**: Long name of layout (e.g. "English (Dvorak)").

**{variant}**: Variant of layout (e.g. "dvorak").

# [EXAMPLES](#EXAMPLES)

```
"hyprland/language": {
	"format": "Lang: {long}",
	"format-en": "AMERICA, HELL YEAH!",
	"format-tr": "As bayrakları",
	"keyboard-name": "at-translated-set-2-keyboard"
}
```

# [STYLE](#STYLE)

•

**#language**

2026-10-30

---

Document: waybar-hyprland-language(5) from waybar 0.15.0-r2 (Chainguard OS)