toggle_special

Transfers the window to/from a designated workspace based on the visibility status of that workspace.

Allows moving the focused window to a special workspace and back. Must be complemented with the togglespecialworkspace Hyprland's command for a better user experience. If not specified, uses the "minimized" special workspace.

Sample hyprland.conf:

bind = $mainMod SHIFT, N, togglespecialworkspace, stash # toggles "stash" special workspace visibility 
bind = $mainMod, N, exec, pypr toggle_special stash # moves window to/from the "stash" workspace

No other configuration needed, here MOD+SHIFT+N will show every window in "stash" while MOD+N will move the focused window out of it/ to it.

Commands

• toggle_special [name]: moves the focused window to the special workspace "name", or move it back to the active workspace. If none set, a special workspace called "minimized" will be used.

  To toggle the state back to a normal workspace, you'll need to hyprctl dispatch togglespecialworkspace minimized (if you didn't set a name, since "minimized" is the default special workspace that will be used).

  It can also be achieved with a keybinding: bind = $mainMod SHIFT, N, togglespecialworkspace, minimized in hyprland.conf