hyprland-plugins/hyprexpo

HyprExpo

HyprExpo is an overview plugin like Gnome, KDE or wf.

Config

A great start to configure this plugin would be adding this code to the plugin section of your hyprland configuration file:

# .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