OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
hyprland-config medium common DISPUTE

Restore three-finger workspace swiping after gesture:workspace_swipe was removed

hyprlandomarchyarchendeavouroscachyoslaptop
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

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.

The cause above was rewritten on 2026-08-30 to match this note; the fix was corrected by the audit itself.

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.

Sources

gestures-workspace-swipe-does-not-exist-051