Hyprland: Toggle Waybar Instantly with a Keyboard Shortcut

In a minimalist Hyprland environment, every pixel matters. While Waybar is essential for system feedback, it does not need to remain visible at all times. Being able to toggle it instantly provides a cleaner workspace without sacrificing access to information.

Minimal Hyprland desktop illustration showing a keyboard shortcut “SUPER + W” toggling Waybar on and off, with the system bar transitioning between visible and hidden states.

Keyboard Shortcut

The shortcut uses the Super key (⌘ / Windows key) combined with W.

• Super + W → Toggle Waybar visibility (show / hide)

This combination is easy to reach and unlikely to conflict with application-level shortcuts.

Waybar supports runtime control via UNIX signals. Sending the SIGUSR1 signal instructs Waybar to toggle its visibility state (show or hide) without restarting the process or reloading its configuration.

Add the following binding to your ~/.config/hypr/hyprland.conf file:

bind = SUPER, W, exec, killall -SIGUSR1 waybar

Technical Breakdown

• killall -SIGUSR1 waybar sends a user-defined signal, not a termination request
• Waybar listens for SIGUSR1 and handles it internally
• The bar toggles instantly between visible and hidden states
• No flicker, no reload, no configuration reparse

Practical Benefits

• Maximizes usable screen space for focused or fullscreen work
• Keeps system information one keystroke away
• Avoids unnecessary process restarts
• Predictable, reversible, and low overhead

Recommended Variations

Depending on your workflow, alternative bindings may feel more natural:

• Super + B: commonly associated with bars or panels
• Super + Shift + W: reduces the risk of accidental toggles

The signaling mechanism remains identical; only the key combination changes. Choose a binding that aligns with your muscle memory and existing shortcuts.

This small tweak fits naturally into Hyprland’s philosophy: explicit control, minimalism, and fast interaction.