Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v0.57.2 (2026-11-09), so it may lag behind newer releases.
Thanks. Marked useful.
Thanks. The report went to osfeed, and the line gets checked against the repository.
Tile, 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 Hyprland
Animate windows and workspaces with custom bezier curves, and add blur, gradient borders, shadows and rounded corners.
1 other tool for: Round window cornersWrong?
Use workspaces that are created and removed on the fly, per monitor.
1 other tool for: Use workspaces across monitorsWrong?
Keep apps on a special workspace that you show and hide with a key, like a scratchpad.
2 other tools for: Drop down a terminal with a keyWrong?
Group windows into tabs that share one tile, with a bar to switch between them.
1 other tool for: Group windows in tabsWrong?
Set rules per window, monitor or layer, such as where an app opens, its size, opacity or whether it floats.
2 other tools for: Set rules for windowsWrong?
Bind keys to any action, group binds into submaps, and pass global keybinds to the apps you choose.
2 other tools for: Set key bindingsWrong?
Control the compositor and react to its events from scripts through hyprctl and a socket.
Wrong?
Show all 22
Add features through plugins installed with the built-in plugin manager, hyprpm.
1 other tool for: Add Hyprland pluginsWrong?
Allow screen tearing for chosen windows to cut input latency in games.
Wrong?
See config changes applied as soon as you save the file, without restarting.
3 other tools for: Reload config without restartingWrong?
Type with an input method or on-screen input panel through native Wayland support.
Wrong?
Hide chosen layers, such as notifications or a bar, from screen sharing and screenshots taken by other apps.
Wrong?
Reset all idle timers on demand, so idle actions such as locking start counting from zero.
1 other tool for: Keep the screen awakeWrong?
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.
Wrong?
Zoom into the screen to see details, with a camera that follows the cursor or stays in place.
Wrong?
Arrange windows in a scrolling layout: columns side by side on a strip that scrolls left, right, up or down.
Wrong?
Show one window at a time across the workspace with the monocle layout.
Wrong?
Use a different layout on each workspace.
Wrong?
Write the configuration in Lua (hyprland.lua), with variables, functions and an API for binds, rules and layouts.
1 other tool for: Configure in LuaGood to know
Introduced as work in progress; the example config is not exhaustive.
Wrong?
Load an ICC color profile for a monitor.
Wrong?
Focus a window with a click without sending that click to the application.
Good to know
Opt-in through `input:swallow_focus_click`; disabled by default.
Wrong?
Before you upgrade Hyprland
Newest firstConvert `hyprland.conf` to `hyprland.lua` before upgrading: legacy configuration support is removed in v0.57.0.
Read the evidence
Wrong?
When building from source, install Aquamarine >=0.15.0, hyprutils >=0.14.3, libcanberra and packaged hyprland-protocols >=0.8.0; the bundled protocols fallback is gone.
Read the evidence
Wrong?
Install `hyprwayland-scanner` on PATH before adding or updating plugins with `hyprpm`; its dependency check now explicitly requires it.
Read the evidence
Wrong?
Show 26 older
Update workspace parsers to use the string `address` and `type` fields; workspace JSON now includes `id` only for numbered workspaces. Text output uses workspace addresses too.
Read the evidence
Wrong?
Treat workspace identifiers in socket2 events such as `workspacev2`, `createworkspacev2` and `moveworkspacev2` as addresses, not necessarily integers.
Read the evidence
Wrong?
Use `addressable_name` in place of workspace `config_name`; handle `id` being nil for non-numbered workspaces. Window `stable_id` is now a hexadecimal string rather than an integer.
Read the evidence
Wrong?
Call dispatcher factories before passing them to `hl.bind` or `hl.dispatch`, remove excess factory arguments, and remove duplicate keys from bind strings; these mistakes are now rejected.
Read the evidence
Wrong?
Replace `misc:layers_hog_keyboard_focus` with `layers:layers_hog_keyboard_focus`; the old option is deprecated.
Read the evidence
Wrong?
Replace `debug:invalidate_fp16` with `debug:invalidate_buffers` (0 or 1); the old setting no longer has an effect. Remove `debug:fifo_pending_workaround`, which is gone.
Read the evidence
Wrong?
Use workspace rules instead of `dwindle:special_scale_factor` or `master:special_scale_factor`; both settings are deprecated.
Read the evidence
Wrong?
Replace the deprecated `on_created_empty` workspace rule with a `workspace.created` Lua handler checking the workspace's `is_empty` field.
Wrong?
Replace the `group:drag_into_group` string value `only when dragging into the groupbar` with `only_into_groupbar` (or numeric 2).
Read the evidence
Wrong?
The `workspace.created` Lua event now fires after workspace setup; use `workspace.created_early` for the previous early timing.
Read the evidence
Wrong?
Application bells now play a sound by default. Set `misc:bell_sound` to `none` or an empty string to mute it, or to a WAV/OGG path for a custom sound.
Read the evidence
Wrong?
Dragging a tiled or fullscreen window into floating mode centers it on the cursor by default; set `binds:drag_center_window` to false to disable this.
Read the evidence
Wrong?
Pre-existing top layers render beneath covering fullscreen windows. `layers:allow_new_top_layers_over_existing_fullscreen` controls newly mapped top layers; bottom and background layers remain available beneath fullscreen in v0.57.2.
Read the evidence
Wrong?
Hyprland can start `hyprland-session.target` for services tied to the session; set `HYPRLAND_NO_SD_TARGET=1` to opt out. This uses the existing systemd activation-environment path.
Read the evidence
Wrong?
Bundled `hyprctl` shell completions are removed; no replacement is stated in the release notes.
Read the evidence
Wrong?
v0.57.1 restores opt-in `quirks:skip_non_kms_dmabuf_formats` after v0.57.0 enabled it by default, addressing NVIDIA black-screen regressions.
Read the evidence
Wrong?
v0.57.2 stops acquiring realtime scheduling after crashes under heavy load; the build option `NO_RTKIT` is now obsolete.
Wrong?
`hyprctl monitors` and `hyprctl monitors -j` print `scale`, `sdrBrightness`, `sdrSaturation` and `sdrMinLuminance` at full precision instead of rounded to two decimals.
Read the evidence
Wrong?
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
Wrong?
The example config shipped with Hyprland is now example/hyprland.lua; example/hyprland.conf was removed.
Read the evidence
Wrong?
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
Wrong?
Move plugin:hyprscrolling: options to scrolling: and set the scrolling layout instead of loading the hyprscrolling plugin.
Read the evidence
Wrong?
Replace the togglesplit and swapsplit dispatchers with layoutmsg togglesplit and layoutmsg swapsplit.
Read the evidence
Wrong?
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
Wrong?
Rewrite every windowrule and layerrule line in the new syntax described in the Window Rules wiki page; old lines no longer apply.
Wrong?
Replace misc:new_window_takes_over_fullscreen and master:inherit_fullscreen with misc:on_focus_under_fullscreen.
Read the evidence
Wrong?
Hyprland release history 9
with v0.57.0, v0.57.1
Make windows wobble as you move or resize them.
Details
v0.57 adds wobble and selectable blur variants, removes legacy .conf support, and changes workspace identifiers exposed to scripts. v0.57.1 and v0.57.2 fix regressions, including NVIDIA black screens and realtime-scheduling crashes.
Also: Choose blur variants, migrate legacy configs to Lua, update workspace scripts, and get fixes for remapped modifiers and special-workspace unpinning.
Hyprland v0.57.2 on Linux, including v0.57.0 and v0.57.1; Lua configuration is required. Source builds require Aquamarine >=0.15.0, hyprutils >=0.14.3, libcanberra and packaged hyprland-protocols >=0.8.0.
Seeded by @iluxav with Codex
Read the evidence
- hyprwm/Hyprland/releases/tag/v0.57.0
- hyprwm/Hyprland/blob/v0.57.2/src/config/ConfigManager.cpp
- hyprwm/Hyprland/blob/v0.57.2/CMakeLists.txt
- hyprwm/Hyprland/blob/v0.57.2/hyprpm/src/core/PluginManager.cpp
- hyprwm/Hyprland/blob/v0.57.2/src/ipc/s1/Commands.cpp
- hyprwm/Hyprland/blob/v0.57.2/src/workspace/HLWorkspace.cpp
- hyprwm/Hyprland/blob/v0.57.2/src/state/workspace/PlacementController.cpp
- hyprwm/Hyprland/blob/v0.57.2/src/config/lua/objects/LuaWorkspace.cpp
- hyprwm/Hyprland/blob/v0.57.2/src/config/lua/objects/LuaWindow.cpp
- hyprwm/Hyprland/blob/v0.57.2/src/config/lua/bindings/LuaBindingsDispatcherUtils.cpp
- hyprwm/Hyprland/blob/v0.57.2/src/config/values/ConfigValues.cpp
- hyprwm/Hyprland/compare/v0.56.2...v0.57.2
- hyprwm/Hyprland/blob/v0.57.2/src/config/lua/bindings/LuaBindingsConfigRules.cpp
- hyprwm/Hyprland/blob/v0.57.2/src/config/lua/LuaEventHandler.cpp
- hyprwm/Hyprland/releases/tag/v0.57.2
- hyprwm/Hyprland/blob/v0.57.2/src/Compositor.cpp
- hyprwm/Hyprland/blob/v0.57.2/systemd/hyprland-session.target
- hyprwm/Hyprland/releases/tag/v0.57.1
Reload your configuration from the ground up with hyprctl reload full-reset without crashing the compositor.
Details
`hyprctl reload full-reset` no longer registers every config value twice and crashes; `hyprctl monitors` prints `scale`, `sdrBrightness`, `sdrSaturation` and `sdrMinLuminance` unrounded. IME popups draw above every layer and the lock screen, and on the scrolling layout `focus` in a direction leaves a fullscreen window.
Also: Screen-share window capture shows the software cursor again; popups on keyboard-exclusive layers get mouse events; sendshortcut works from binds with a modifier; gaps_out no longer overrides float_gaps; mirror rules apply when the target connects later; LuaLS stub covers more hl functions.
Hyprland v0.56.2, a patch release of fixes backported from main; no new dependencies.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
Read the evidence
Add motion blur to moving windows.
Correction: The ground-up reload command is `hyprctl reload full-reset`, not `hyprctl config full-reload`, and it crashed the compositor until v0.56.2.
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
Read the evidence
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code
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.
Seeded by @iluxav with Claude Code