waybar-hyprland-language(5)

🌸 waybar-hyprland-language(5) — the language module, bestie edition 🌸

okay so this is the manual page for waybar's hyprland language module, and honestly? she's cute and she knows it 💅

---

✨ NAME ✨

waybar — the hyprland language module 🦋

---

💖 DESCRIPTION 💖

The language module displays the currently selected language. that's it. that's the whole job. and she does it beautifully 👑

---

🎀 CONFIGURATION 🎀

you reach her by addressing her as hyprland/language — like, that's her handle, that's how you @ her in your config 📨

• format — typeof: string, default: {} this is the format, aka how the info should be displayed. the whole vibe of the output, fr.
• format-<lang> — typeof: string gives a different, alternative name to display per language, where <lang> is the language of your choosing. you can pass this multiple times with multiple languages — check the example below for how that looks, iykyk 🌈
• keyboard-name — typeof: string specifies which keyboard to use from the hyprctl devices output. and bestie, listen: using the option that begins with "at-translated-set..." is recommended. that's the one. trust 💅
• menu — typeof: string the action that popups the menu.
• menu-file — typeof: string the location of the menu descriptor file. there needs to be an element of type GtkMenu with id menu in there — non-negotiable, queen 🫶
• menu-actions — typeof: array the actions corresponding to the buttons of the menu.
• expand — typeof: bool, default: false lets this module consume all left over space dynamically. she's a grower, not a shower 🌱

---

🌟 FORMAT REPLACEMENTS 🌟

these are the little magic words you can drop into your format. each one gets swapped for real info ✨

• {short}: short name of layout (e.g. "us"). equals to {} — literally the same thing, no cap.
• {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 🍓

not me showing you the exact config so you can just copy it, obsessed 😭

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

---

💅 STYLE 💅

the css selector you're gonna want, and she ate:

• #language

---

and that's the whole page, pookie 💜 go forth and style your layout indicator, main character energy only 👑

signing off — this was waybar-hyprland-language(5), dated 2026-02-08, from the File Formats Manual section 🎀