Restore three-finger workspace swiping after gesture:workspace_swipe was removed
The new gesture keyword and every Lua example are confirmed verbatim against the current Gestures wiki page (hl.gesture with fingers/direction/mods/scale/action, and the ALT+down close and 4-finger fullscreen examples are near-copies of the wiki's). animations:first_launch_animation -> monitorAdded is plausible, and monitorAdded exists in the current animation tree. But the stated cause is wrong and the fix is destructive because of it: the gestures: category was NOT removed. The current Variables wiki still documents a full gestures. subcategory (workspace_swipe_distance, workspace_swipe_invert, workspace_swipe_touch, workspace_swipe_cancel_ratio, workspace_swipe_create_new, workspace_swipe_direction_lock, workspace_swipe_forever, close_max_timeout, plus gestures.scrolling.*). Only three keys were removed. The wiki says so explicitly: 'workspace_swipe, workspace_swipe_fingers and workspace_swipe_min_fingers were removed in favor of the new gestures system.' Telling a user to 'Delete the old gestures { ... } block entirely' silently discards their swipe tuning (invert, distance, cancel_ratio, forever), which is a real behavior regression with no error to point at.
Symptom
Config error in file /home/xxx/.local/share/omarchy/default/hypr/input.conf at line 20: config option <gesture:workspace_swipe> does not exist. Three-finger workspace swiping on the trackpad has stopped working.
Cause
Hyprland 0.51 (Sept 2025) removed exactly three keys (gestures:workspace_swipe, gestures:workspace_swipe_fingers and gestures:workspace_swipe_min_fingers) in favour of a general-purpose gesture keyword that binds any finger count + direction to an action. The gestures. category itself was **not** removed: workspace_swipe_distance, workspace_swipe_invert, workspace_swipe_touch, workspace_swipe_cancel_ratio, workspace_swipe_create_new, workspace_swipe_direction_lock, workspace_swipe_forever, close_max_timeout and gestures.scrolling.* are all still documented, so deleting the whole block discards real swipe tuning with no error to point at.
Fix
Do NOT delete the whole gestures block. It still exists. Only three keys were removed in 0.51: workspace_swipe, workspace_swipe_fingers, workspace_swipe_min_fingers. Everything else in gestures. (workspace_swipe_distance, workspace_swipe_invert, workspace_swipe_touch, workspace_swipe_cancel_ratio, workspace_swipe_create_new, workspace_swipe_direction_lock, workspace_swipe_forever, close_max_timeout, gestures.scrolling.*) is still valid and still tunes the swipe.
For hyprlang (0.51-0.54), remove only the three dead keys and keep the rest:
gestures {
# workspace_swipe = true # REMOVED in 0.51
# workspace_swipe_fingers = 3 # REMOVED in 0.51
# workspace_swipe_min_fingers = ... # REMOVED in 0.51
workspace_swipe_distance = 300 # still valid
workspace_swipe_invert = true # still valid
}
gesture = 3, horizontal, workspace
Lua (0.55+):
hl.config({ gestures = { workspace_swipe_distance = 300, workspace_swipe_invert = true } })
hl.gesture({ fingers = 3, direction = "horizontal", action = "workspace" })
Verify what survived on your build with hyprctl getoption gestures.workspace_swipe_distance.
Verify
Swipe three fingers horizontally on the touchpad and workspaces move. hyprctl configerrors is clean.