mirror of
https://github.com/hyprwm/hyprland-plugins.git
synced 2025-10-29 19:58:49 +00:00
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
enable_gesture = true # laptop touchpad
gesture_fingers = 3 # 3 or 4
gesture_distance = 300 # how far is the "max"
gesture_positive = true # positive = swipe down. Negative = swipe up.
}
}
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 |
| enable_gesture | boolean | enable touchpad gestures | true |
| gesture_fingers | 3 or 4 |
how many fingers are needed in the gesture | 3 |
| gesture_distance | number | how far is the max | 300 |
| gesture_positive | boolean | whether to swipe down (true), or up (false) | true |
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 |