Hyprland
A dynamic tiling Wayland compositor with animations
Unclaimed
Built by @hyprwm on GitHub. This page was written by @iluxav from public sources, last updated for v0.56.1 (2026-07-27), and may lag behind new releases.
Maintain Hyprland? Claim itTile, float and group your windows on Wayland with animations, blur and per-window rules, all set from one config file that reloads as you save.
What you can do with it
Animate windows and workspaces with custom bezier curves, and add blur, gradient borders, shadows and rounded corners.
Use workspaces that are created and removed on the fly, per monitor.
Keep apps on a special workspace that you show and hide with a key, like a scratchpad.
Group windows into tabs that share one tile, with a bar to switch between them.
Set rules per window, monitor or layer, such as where an app opens, its size, opacity or whether it floats.
Bind keys to any action, group binds into submaps, and pass global keybinds to the apps you choose.
Control the compositor and react to its events from scripts through hyprctl and a socket.
Show all 21
Add features through plugins installed with the built-in plugin manager, hyprpm.
Allow screen tearing for chosen windows to cut input latency in games.
See config changes applied as soon as you save the file, without restarting.
Type with an input method or on-screen input panel through native Wayland support.
Hide chosen layers, such as notifications or a bar, from screen sharing and screenshots taken by other apps.
Reset all idle timers on demand, so idle actions such as locking start counting from zero.
Rotate the input of a touchscreen, tablet or other device to match a rotated display.
Good to know
Only for devices whose driver supports rotation through libinput.
Zoom into the screen to see details, with a camera that follows the cursor or stays in place.
Arrange windows in a scrolling layout: columns side by side on a strip that scrolls left, right, up or down.
Show one window at a time across the workspace with the monocle layout.
Use a different layout on each workspace.
Write the configuration in Lua (hyprland.lua), with variables, functions and an API for binds, rules and layouts.
Good to know
Introduced as work in progress; the example config is not exhaustive.
Load an ICC color profile for a monitor.
Before you upgrade
Newest firstv0.56.12026-07-27
Move your configuration from hyprland.conf to hyprland.lua before upgrading to 0.57; from 0.56.1 a .conf config shows a warning on startup.
Read the evidence
v0.55.22026-05-16
The example config shipped with Hyprland is now example/hyprland.lua; example/hyprland.conf was removed.
Read the evidence
v0.55.22026-05-16
Delete dwindle:pseudotile, decoration:shadow:ignore_window (now always on) and render:cm_fs_passthrough (handled by render:cm_auto_hdr); rename misc:vfr to debug:vfr.
Read the evidence
Show 6 older
v0.54.12026-03-03
Move plugin:hyprscrolling: options to scrolling: and set the scrolling layout instead of loading the hyprscrolling plugin.
Read the evidence
v0.54.12026-03-03
Replace the togglesplit and swapsplit dispatchers with layoutmsg togglesplit and layoutmsg swapsplit.
Read the evidence
v0.54.12026-03-03
Rename dwindle:single_window_aspect_ratio and dwindle:single_window_aspect_ratio_tolerance to layout:single_window_aspect_ratio and layout:single_window_aspect_ratio_tolerance; they now apply to every layout.
Read the evidence
v0.53.12026-01-02
Rewrite every windowrule and layerrule line in the new syntax described in the Window Rules wiki page; old lines no longer apply.
v0.53.12026-01-02
Replace misc:new_window_takes_over_fullscreen and master:inherit_fullscreen with misc:on_focus_under_fullscreen.
Read the evidence
v0.52.12025-11-09
Rename misc:disable_hyprland_qtutils_check to misc:disable_hyprland_guiutils_check; hyprland-qtutils is archived in favor of hyprland-guiutils.
Read the evidence
Release history 7
v0.56.12026-07-27
Get a warning on startup while your config still uses the .conf format, before 0.57 drops it.
Details
A .conf config now shows a notification: support for the .conf format will be removed in Hyprland 0.57. New changeworkspaceid socket2 event.
Hyprland v0.56.1.
Action requiredNow stable / inferred: Write the configuration in Lua (hyprland.lua), with…Improved: Control the compositor and react to its events from…
Seeded by @iluxav with Claude Code (canido)
Read the evidence
v0.56.02026-07-20
Add motion blur to moving windows.
Details
New motion blur and tonemap settings, Lua-driven live gestures, hyprctl repl and hyprctl config full-reload, no_auto_hdr window rule, stableid: window selector and groupbar disable_when_only. No breaking changes.
Also: gradient and angle animation for glow and shadow; tablet eraser and pressure options; xdg interactive drags.
Hyprland v0.56.0.
Improved: Animate windows and workspaces with custom bezier c…Improved: Write the configuration in Lua (hyprland.lua), with…Improved: Set rules per window, monitor or layer, such as whe…Improved: Group windows into tabs that share one tile, with a…Improved: See config changes applied as soon as you save the…
Seeded by @iluxav with Claude Code (canido)
v0.55.22026-05-16
Write your Hyprland configuration in Lua instead of hyprland.conf.
Details
A Lua config manager is used when hyprland.lua exists; the example config is now example/hyprland.lua. New spring animations, glow decoration, ICC profiles, device-specific binds and device tags, and a confine_pointer window rule. Four options were removed or moved. Groups v0.55.0 to v0.55.2.
Also: scrolling layout: center, expel and consume, wrapping options; groupbar middle_click_close.
Hyprland v0.55.0 and later; the Lua config is new and its options are still being filled in.
Added: Write the configuration in Lua (hyprland.lua), with…Behavior changed: Write the configuration in Lua (hyprland.lua), with…Improved: Animate windows and workspaces with custom bezier c…Added: Load an ICC color profile for a monitor.Improved: Bind keys to any action, group binds into submaps,…Improved / inferred: Set rules per window, monitor or layer, such as whe…Improved: Arrange windows in a scrolling layout: columns side…Action required
Seeded by @iluxav with Claude Code (canido)
Read the evidence
v0.54.12026-03-03
Arrange windows in a built-in scrolling layout, as a strip of columns you scroll through.
Details
Layouts were rewritten: new built-in scrolling and monocle layouts, a layout: workspace rule for per-workspace layouts, and togglesplit/swapsplit removed in favor of layoutmsg. Groups v0.54.0 and v0.54.1.
Also: cursor zoom gesture; groupbar text padding.
Hyprland v0.54.0 and later.
Added: Arrange windows in a scrolling layout: columns side…Added: Show one window at a time across the workspace with…Added: Use a different layout on each workspace.Action required: Arrange windows in a scrolling layout: columns side…Action required: Tile windows automatically with the dwindle or mast…Action required: Tile windows automatically with the dwindle or mast…Improved: Zoom into the screen to see details, with a camera…
Seeded by @iluxav with Claude Code (canido)
v0.53.12026-01-02
Zoom into the screen with a camera that stays put instead of following the cursor.
Details
Window rule syntax was rewritten (see the wiki); misc:on_focus_under_fullscreen replaces two fullscreen options. New groupbar blur, detached-camera zoom, tablet cursor hiding and quirks:prefer_hdr. Groups v0.53.0 and v0.53.1.
Also: locale option; hyprpm shows plugin authors.
Hyprland v0.53.0 and later; window rules must be rewritten when upgrading.
Action required: Set rules per window, monitor or layer, such as whe…Action required: Tile windows automatically with the dwindle or mast…Added: Zoom into the screen to see details, with a camera…Improved: Group windows into tabs that share one tile, with a…
Seeded by @iluxav with Claude Code (canido)
v0.52.12025-11-09
Hide chosen layers, such as notifications, from screen sharing.
Details
New noscreenshare layer rule, forceidle dispatcher, set/unset/toggle for the fullscreen dispatcher, an option to rotate an input device, and submaps that close by themselves. Groups v0.52.0 and v0.52.1.
Also: modal window rule property; cursor:zoom_disable_aa; render:non_shader_cm.
Hyprland v0.52.0 and later.
Added: Hide chosen layers, such as notifications or a bar,…Added: Reset all idle timers on demand, so idle actions su…Added: Rotate the input of a touchscreen, tablet or other…Improved: Tile windows automatically with the dwindle or mast…Improved / inferred: Bind keys to any action, group binds into submaps,…Action required
Seeded by @iluxav with Claude Code (canido)
v0.51.12025-09-22
Starting point
Starting point
Tile windows automatically on a Wayland desktop with animations, blur and per-window rules.
Details
State at v0.51.1: dwindle and master layouts, floating, pseudotiling and fullscreen windows, dynamic and special workspaces, window groups, window/monitor/layer rules, keybinds with submaps, socket IPC and hyprctl, plugins through hyprpm.
Hyprland v0.51.1 on Linux; from distribution packages or built from source.
Added: Tile windows automatically with the dwindle or mast…Added: Animate windows and workspaces with custom bezier c…Added: Use workspaces that are created and removed on the…Added: Keep apps on a special workspace that you show and…Added: Group windows into tabs that share one tile, with a…Added: Set rules per window, monitor or layer, such as whe…Added: Bind keys to any action, group binds into submaps,…Added: Control the compositor and react to its events from…Added: Add features through plugins installed with the bui…Added: Allow screen tearing for chosen windows to cut inpu…Added: See config changes applied as soon as you save the…Added: Type with an input method or on-screen input panel…
Seeded by @iluxav with Claude Code (canido)