Skip to content

Dispatchers

Main dispatcher:

ini
bind = SUPER, g, hyprexpo:expo, toggle
optiondescription
toggleshow overview if hidden, hide it if shown
on or enableshow overview
off or disablehide overview
cancelhide overview without switching workspaces
selectselect the hovered workspace
bringmove the top mapped window from the hovered workspace into the current workspace
1..9select that workspace by ID while overview is open; otherwise dispatch a normal workspace switch

Keyboard navigation dispatchers are active during overview:

dispatcherargumentdescription
hyprexpo:kb_focusleft, right, up, or downmove focus across tiles
hyprexpo:kb_confirmnoneselect the focused tile
hyprexpo:kb_selectiindexselect by 1-based visible index
hyprexpo:kb_selectnworkspace IDselect by workspace ID; 0 maps to workspace 10
hyprexpo:kb_selecttokenselect by token; uses the selection-label map when enabled
hyprexpo:move_windowsource target [address]move a window between 1-based visible tile indices; defaults to the top mapped source-window

Hyprland may briefly report invalid dispatcher messages during startup if binds are parsed before plugins are loaded. Those messages are cosmetic; the dispatchers work once the plugin is loaded.

HyprExpo is a maintained Hyprland plugin fork.