Dispatchers

Please keep in mind some layout-specific dispatchers will be listed in the layout pages (See the sidebar).

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

Hyprland allows you to make a group from the current active window with the togglegroup bind dispatcher.

A group is like i3wm’s “tabbed” container. It takes the space of one window, and you can change the window to the next one in the tabbed “group” with the changegroupactive bind dispatcher.

The new group’s border colors are configurable with the appropriate col. settings in the group config section.

You can lock a group with the lockactivegroup dispatcher in order to stop new window from entering this group. In addition, the lockgroups dispatcher can be used to toggle an independent global group lock that will prevent new window from entering any groups, regardless of their local group lock stat.

You can prevent a window from being added to group or becoming a group with the denywindowfromgroup dispatcher. movewindoworgroup will behave like movewindow if current active window or window in direction has this property set.

You have eight choices:

• ID: e.g. 1, 2, or 3

• Relative ID: e.g. +1, -3 or +100

• Relative workspace on monitor: e.g. m+1, m-1 or m+3

• Relative workspace on monitor including empty workspaces: e.g. r+1 or r-3

• Relative open workspace: e.g. e+1 or e-10

• Name: e.g. name:Web, name:Anime or name:Better anime

• Previous workspace: previous

• First available empty workspace: empty

• Special Workspace: special or special:name for named special workspaces.

special is supported ONLY on movetoworkspace and movetoworkspacesilent. Any other dispatcher will result in undocumented behavior.

Numerical workspaces (e.g. 1, 2, 13371337) are allowed ONLY between 1 and 2147483647 (inclusive)

Neither 0 nor 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 can define multiple named special workspaces, but the amount of those is limited to 97 at a time.

For example, to move a window/application to a special workspace you can use the following syntax:

bind = SUPER, C, movetoworkspace, special
#The above syntax will move the window to a special workspace upon pressing 'SUPER'+'C'.
#To see the hidden window you can use the togglespecialworkspace dispatcher mentioned above.

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