waybar-hyprland-window(5)

📦
version 0.15.0 · 10 versions
, in ubuntu resolute, ubuntu stonking

✨ waybar-hyprland-window ✨

okay bestie, welcome to the waybar-hyprland-window(5) manual page 🫶 this is the lil slice of the waybar docs that covers the hyprland window module, and yes it is exactly as cute as it sounds.

🌸 NAME 🌸

waybar — the hyprland window module. that's the whole vibe 💅

🦋 DESCRIPTION 🦋

the window module shows the title of the currently focused window in Hyprland. that's it. that's the job. it's giving tiny but essential 👑

🎀 CONFIGURATION 🎀

you address this module as hyprland/window. here's every knob you can twist, fr fr:

  • format
    • typeof: string
    • default: {title}
    • the format, like, how the info should actually be displayed. on {} the current window title gets shown.
  • rewrite
    • typeof: object
    • rules to rewrite the window title. see rewrite rules below, iykyk.
  • separate-outputs
    • typeof: bool
    • show the active window of the monitor the bar belongs to, instead of the focused window. multitask girlies rise 🫶
  • icon
    • typeof: bool
    • default: false
    • option to hide the application icon.
  • icon-size
    • typeof: integer
    • default: 24
    • option to change the size of the application icon.
  • expand
    • typeof: bool
    • default: false
    • lets this module consume all left over space dynamically. main character energy, honestly.

💖 FORMAT REPLACEMENTS 💖

peep the output of hyprctl clients for examples, bestie 👀

  • {title}: the current title of the focused window.
  • {initialTitle}: the initial title of the focused window.
  • {class}: the current class of the focused window.
  • {initialClass}: the initial class of the focused window.

🌈 REWRITE RULES 🌈

okay so rewrite is an object where the keys are regular expressions and the values are rewrite rules that apply if the expression matches. rules may contain references to captures of the expression — very much a glow-up pipeline ✨

regular expression and replacement follow ECMA-script rules. no cap.

if no expression matches, the title is left unchanged. it's fine, it's fine, it's just vibing.

invalid expressions (e.g., mismatched parentheses 😭) are skipped.

🍓 EXAMPLES 🍓

"hyprland/window": {
     "format": "{}",
     "rewrite": {
          "(.*) - Mozilla Firefox": "🌎 $1",
          "(.*) - zsh": "> [$1]"
     }
}

💅 STYLE 💅

  • #window
  • window#waybar.empty #window When no windows are in the workspace

the following classes are applied to the entire Waybar rather than just the window widget, so pay attention bestie:

  • window#waybar.empty When no windows are in the workspace
  • window#waybar.solo When one tiled window is visible in the workspace (floating windows may be present)
  • window#waybar.<app_id> Where <app_id> is the class (e.g. chromium) of the solo tiled window in the workspace (use hyprctl clients to see classes)
  • window#waybar.floating When there are only floating windows in the workspace
  • window#waybar.fullscreen When there is a fullscreen window in the workspace; useful with Hyprland's fullscreen, 1 mode
  • window#waybar.swallowing When there is a swallowed window in the workspace
that's the whole page, no skips, no summaries, every flag accounted for 💀✨

and that's a wrap, bestie 🎀 this was waybar-hyprland-window(5), dated 2026-02-08, and you absolutely ate that read. go configure something gorgeous, periodt 💖🌸🦋👑

📦 where this page comes from