Hyprland 0.55 has been released as one of the Wayland compositor’s largest updates so far, introducing Lua-based configuration, user-defined layouts, per-output ICC profiles, scrolling improvements, and several renderer and color management changes.
The biggest change is the move to Lua configs. The traditional Hyprlang format remains supported for now, so existing hyprland.conf files will continue to function. At the same time, the project has updated its wiki for the new Lua format and encourages users to migrate.
This transition goes beyond syntax. With Lua, Hyprland 0.55 introduces a Layout API that allows users to define custom window layouts directly in the configuration. These layouts can be applied globally, per workspace, or per monitor, and function like standard Hyprland layouts while remaining user-controlled.
Scrolling has been improved as well. Fullscreen windows are now included in the scrolling tape by default, and a native trackpad gesture is available through scroll_move in Lua. Additional features include expel, consume, consume_or_expel, wrapping options, and an auto_consuming flag for binds.
Moreover, the release adds support for per-output ICC profiles. Users can now load an ICC profile for each display using the icc = "path" setting in the configuration, enabling direct color profile management per monitor.
Color management and rendering have been enhanced, too, with Hyprland now using FP16 precision and improved color management pipelines by default for color-managed displays, resulting in better color accuracy, screen sharing, and overall color handling.
Hyprland 0.55 also introduces new desktop and window management features, such as device tags, a confine_pointer window rule, move_into_or_create_group for the move dispatcher, rotatesplit as a layoutmsg option for the Dwindle layout, a live pinch cursor zoom gesture, and a new glow window decoration.
Finally, this release includes some breaking configuration changes. The dwindle:pseudotile option has been removed due to a lack of functionality. The decoration:shadow:ignore_window option has also been removed and now defaults to enabled.
The render:cm_fs_passthrough option has been removed, with its behavior now managed automatically by render:cm_auto_hdr. Additionally, misc:vfr has moved under debug: as it is intended for debugging and should not be changed in production.
For more details, see the announcement or the project’s GitHub changelog.
