# .config/hypr/hyprland.conf
plugin {
    hyprexpo {
        columns = 3
        gap_size = 5
        bg_col = rgb(111111)
        workspace_method = center current # [center/first] [workspace] e.g. first 1 or center m+1

        gesture_distance = 300 # how far is the "max" for the gesture
    }
}

Properties

property	type	description	default
columns	number	how many desktops are displayed on one line	`3`
gap_size	number	gap between desktops	`5`
bg_col	color	color in gaps (between desktops)	`rgb(000000)`
workspace_method	[center/first] [workspace]	position of the desktops	`center current`
skip_empty	boolean	whether the grid displays workspaces sequentially by id using selector "r" (`false`) or skips empty workspaces using selector "m" (`true`)	`false`
gesture_distance	number	how far is the max for the gesture	`300`

Keywords

name	description	arguments
hyprexpo-gesture	same as gesture, but for hyprexpo gestures. Supports: `expo`.	Same as gesture

Binding

# hyprland.conf
bind = MODIFIER, KEY, hyprexpo:expo, OPTION

Example:

# This will toggle HyprExpo when SUPER+g is pressed
bind = SUPER, g, hyprexpo:expo, toggle

Here are a list of options you can use:

option	description
toggle	displays if hidden, hide if displayed
select	selects the hovered desktop
off	hides the overview
disable	same as `off`
on	displays the overview
enable	same as `on`