Dispatchers
Please keep in mind some layout-specific dispatchers will be listed in the layout pages (See the sidebar).
| Param type | Description |
|---|---|
| window | a window. Any of the following: Class regex, title: and a title regex, pid: and the pid, address: and the address |
| workspace | see below. |
| direction | l r u d left right up down |
| monitor | One of: direction, ID, name, current, relative (e.g. +1 or -1) |
| resizeparams | Pixel delta vec2 (e.g. 10 -10) or exact followed by exact vec2, e.g. exact 1280 720) |
| floatdelta | a float value delta, e.g -0.2 or +0.2. |
| workspaceopt | see below. |
| Dispatcher | Description | Params |
|---|---|---|
| exec | executes a shell command | command (supports rules, see below) |
| pass | passes the key (with mods) to a specified window. Can be used as a workaround to global keybinds not working on Wayland. | window |
| killactive | closes (not kills) the active window | none |
| closewindow | closes a specified window | window |
| workspace | changes the workspace | workspace |
| movetoworkspace | moves the focused window to a workspace | workspace OR workspace,window for a specific window |
| movetoworkspacesilent | same as above, but doesnt switch to the workspace | workspace OR workspace,window for a specific window |
| togglefloating | toggles the current window’s floating state | left empty / active for current, or window for a specific window |
| fullscreen | toggles the focused window’s fullscreen state | 0 - fullscreen (takes your entire screen), 1 - maximize (keeps gaps and bar(s)) |
| dpms | sets all monitors’ DPMS status. Do not use with a keybind directly. | on or off, for specific monitor add monitor name after a space |
| pseudo | toggles the focused window’s pseudo mode | none |
| pin | pins the active window (shown on all workspaces) note: floating only | none |
| movefocus | moves the focus in a direction | direction |
| movewindow | moves the active window in a direction or to a monitor | direction or mon: and a monitor |
| centerwindow | center the active window note: floating only | none |
| resizeactive | resizes the active window | resizeparams |
| moveactive | moves the active window | resizeparams |
| resizewindowpixel | resizes a selected window | resizeparams,window, e.g. 100 100,^(kitty)$ |
| movewindowpixel | moves a selected window | resizeparams,window |
| cyclenext | focuses the next window on a workspace | none (for next) or prev (for previous) |
| swapnext | swaps the focused window with the next window on a workspace | none (for next) or prev (for previous) |
| focuswindow | focuses the first window matching | window |
| focusmonitor | focuses a monitor | monitor |
| splitratio | changes the split ratio | floatdelta |
| toggleopaque | toggles the current window to always be opaque. Will override the opaque window rules. |
none |
| movecursortocorner | moves the cursor to the corner of the active window | direction, 0 - 3, bottom left - 0, bottom right - 1, top right - 2, top left - 3 |
| workspaceopt | toggles a workspace option for the active workspace. | workspaceopt |
| exit | exits the compositor with no questions asked. | none |
| forcerendererreload | forces the renderer to reload all resources and outputs | none |
| movecurrentworkspacetomonitor | Moves the active workspace to a monitor | monitor |
| moveworkspacetomonitor | Moves a workspace to a monitor | workspace and a monitor separated by a space |
| swapactiveworkspaces | Swaps the active workspaces between two monitors | two monitors separated by a space |
| bringactivetotop | Brings the current window to the top of the stack | none |
| togglespecialworkspace | toggles a special workspace on/off | none (for the first) or name for named (name has to be a special workspace’s name) |
it is NOT recommended to set DPMS with a keybind directly, as it might cause undefined behavior. Instead, consider something like
bind = MOD,KEY,exec,sleep 1 && hyprctl dispatch dpms off
You have eight choices:
-
ID: e.g.
1,2, or3 -
Relative ID: e.g.
+1,-3or+100 -
Relative workspace on monitor: e.g.
m+1,m-1orm+3 -
Relative open workspace: e.g.
e+1ore-10 -
Name: e.g.
name:Web,name:Animeorname:Better anime -
Previous workspace:
previous -
First available empty workspace:
empty -
Special Workspace:
specialorspecial:namefor named special workspaces.
specialis supported ONLY onmovetoworkspace. Any other dispatcher will result in undocumented behavior.
Numerical workspaces (e.g.
1,2,127634934729) are allowed ONLY between 1 and 9223372036854775806 (inclusive)Neither
0nor negative numbers are allowed.
A special workspace is what is called a “scratchpad” in some other places. A workspace that you can toggle on/off on any monitor.
You cannot have floating windows in a Special workspace. Making a window floating will send it to the currently active real workspace.
You can define multiple named special workspaces, but the amount of those is limited to 97 at a time.
allfloat -> makes all new windows floating (also floats/unfloats windows on toggle)
allpseudo -> makes all new windows pseudo (also pseudos/unpseudos on toggle)
The exec dispatcher supports adding rules. Please note some windows might work better, some
worse. It records the PID of the spawned process and uses that. If your process e.g. forks and then
the fork opens a window, this will not work.
The syntax is:
bind = mod, key, exec, [rules...] command
For example:
bind = SUPER, E, exec, [workspace 2 silent;float;noanim] kitty