Breaking changes tracker

[vaxerski]

This issue serves as a tracker for breaking changes in -git.

Subscribe to this issue if you want to be notified.

Please note that if you do not use -git, you should read release notes instead, as they will also have all the breaking changes.

[fufexan]

For people that have been using hyprland-systemd.desktop to launch Hyprland as a systemd service: We have removed the systemd session file, and replaced it with the more complete approach of using uwsm to handle the session. There's a new session file called hyprland-uwsm.desktop. Follow the wiki instructions to set up uwsm, and everything will work just fine.

(NixOS users, we'll have you covered soon too. In the meantime, take a look at my dots if you want to use uwsm)

For the technically inclined, here are the discussions that led to this change:

• https://github.com/hyprwm/Hyprland/pull/8339
• https://github.com/hyprwm/Hyprland/pull/8376
• https://github.com/hyprwm/hyprland-wiki/pull/850

[vaxerski]

With https://github.com/hyprwm/Hyprland/pull/8399, dumb_copy is now gone in favor of cursor:use_cpu_buffer. This should allow Nvidia users to have hardware cursors without the hitches dumb copy would cause.

Please note it's a bit experimental atm

[vaxerski]

with https://github.com/hyprwm/Hyprland/pull/8635 hyprland now depends on hyprgraphics>=0.1.1

[vaxerski]

with #8736 hyprland now depends on re2

[vaxerski]

With the move to RE2, your regexes now require a full match instead of any match.

For example, in the case of jeremy:

• jeremy: OK
• ^(jeremy)$: OK
• jer: Used to match, now won't. You'll need to do .*jer.* to make it act like before. (Consider not doing that though, make a better regex.)

[vaxerski]

With https://github.com/hyprwm/Hyprland/pull/8812, hyprland now depends on glaze

[vaxerski]

With https://github.com/hyprwm/Hyprland/pull/8871 master:always_center_master has been replaced with a more flexible master:slave_count_for_center_master

[vaxerski]

with https://github.com/hyprwm/Hyprland/pull/9217 opengl:force_introspection is gone.

[vaxerski]

with #9437 render:allow_early_buffer_release is gone. It's not needed anymore.

[vaxerski]

with https://github.com/hyprwm/Hyprland/commit/ec4bea7901bdb1f36d33354c02e36d7e03b1ac1e windowrule v1 syntax is nuked. windowrule and windowrulev2 will behave the same (v2) and windowrulev2 is deprecated in favor of windowrule

[vaxerski]

with https://github.com/hyprwm/Hyprland/pull/9945 cursor:warp_on_change_workspace no longer controls warps for special workspaces. Use warp_on_toggle_special for more fine control.

[vaxerski]

with https://github.com/hyprwm/Hyprland/pull/10201, master:center_master_slaves_on_right has been changed to master:center_master_fallback providing more options than just right.

[vaxerski]

with #10211, you'll need to input your sudo password for sensitive hyprpm operations, as well as your already added repositories will be reset (you will need to readd and re-enable plugins)

[vaxerski]

with https://github.com/hyprwm/Hyprland/pull/10408 legacy renderer is dropped. Hyprland now requires GLES3 support from your driver.

[vaxerski]

with https://github.com/hyprwm/Hyprland/commit/86b5e3bfbc99237bb28a253fbef49b9c1b7bc3a3 explicit_sync settings in render: have been nuked, as they weren't doing anything anymore. Explicit sync is used by default.

[vaxerski]

with https://github.com/hyprwm/Hyprland/pull/10991 render ahead of time stuff is removed. It wasn't used and was broken anyways.

[vaxerski]

with https://github.com/hyprwm/Hyprland/pull/11453 animations:first_launch_animation is gone. Use the new monitorAdded anim leaf.

[vaxerski]

with https://github.com/hyprwm/Hyprland/pull/11490 gestures:workspace_swipe, gestures:workspace_swipe_fingers and gestures:workspace_swipe_min_fingers are gone

[vaxerski]

with https://github.com/hyprwm/Hyprland/pull/12231 misc:disable_hyprland_qtutils_check -> misc:disable_hyprland_guiutils_check, as we now recommend hyprland-guiutils, replacing the (now archived) hyprland-qtutils