KEYBINDINGS.md

July 31, 2026 · View on GitHub

_{// design by t2}

hyde_banner

Window Management Misc Launcher Hardware Controls Utilities Theming and Wallpaper Workspaces

Here are all HyDE specific keybindings listed.

Tip

Super + / shows the keybindings.

Keys	Action
`SUPER` + `Q`	close focused window
`ALT` + `F4`	close focused window
`SUPER` + `ALT` + `F4`	kill focused window
`SUPER` + `Delete`	exit hyprland session
`SUPER` + `W`	toggle float
`SUPER` + `G`	toggle group
`ALT` + `P`	toggle pseudotile
`Shift` + `F11`	cycle fullscreen states
`SUPER` + `L`	lock screen
`SUPER` + `SHIFT` + `F`	toggle pin on focused window
`ALT` + `CTRL` + `Delete`	logout menu
`SUPER` + `CTRL` + `B`	toggle waybar
`SUPER` + `J`	toggle split

Keys	Action
`SUPER` + `CTRL` + `H`	change active group backwards
`SUPER` + `CTRL` + `L`	change active group forwards

Change focus

Keys	Action
`SUPER` + `Left`	focus left
`SUPER` + `Right`	focus right
`SUPER` + `Up`	focus up
`SUPER` + `Down`	focus down

Alt-tab switcher

Holding ALT keeps the switcher open; releasing it applies the selection.

Keys	Action
`ALT` + `Tab`	next window
`ALT` + `SHIFT` + `Tab`	previous window

Resize Active Window

Keys	Action
`SUPER` + `SHIFT` + `Right`	resize window right
`SUPER` + `SHIFT` + `Left`	resize window left
`SUPER` + `SHIFT` + `Up`	resize window up
`SUPER` + `SHIFT` + `Down`	resize window down

Move & Resize with mouse

Keys	Action
`SUPER` + `mouse:272`	hold to move window
`SUPER` + `mouse:273`	hold to resize window
`SUPER` + `Z`	hold to move window
`SUPER` + `X`	hold to resize window

Keys	Action
`SUPER` + `CTRL` + `SHIFT` + `left`	move activewindow to the left
`SUPER` + `CTRL` + `SHIFT` + `right`	move activewindow to the right
`SUPER` + `CTRL` + `SHIFT` + `up`	move activewindow up
`SUPER` + `CTRL` + `SHIFT` + `down`	move activewindow down

Apps

Keys	Action
`SUPER` + `T`	terminal emulator
`SUPER` + `ALT` + `T`	dropdown terminal
`SUPER` + `E`	file explorer
`SUPER` + `C`	text editor
`SUPER` + `B`	web browser
`CTRL` + `SHIFT` + `Escape`	system monitor

Rofi menus

Keys	Action
`SUPER` + `A`	application finder
`SUPER` + `TAB`	window switcher
`SUPER` + `SHIFT` + `E`	file finder
`SUPER` + `slash`	keybindings hint
`SUPER` + `comma`	emoji picker
`SUPER` + `period`	glyph picker
`SUPER` + `V`	clipboard
`SUPER` + `SHIFT` + `V`	clipboard manager
`SUPER` + `SHIFT` + `A`	select rofi launcher
`SUPER` + `SHIFT` + `K`	calculator
`SUPER` + `SHIFT` + `slash`	web search

Audio

Keys	Action
`None` + `F10`	toggle mute output
`None` + `XF86AudioMute`	toggle mute output
`None` + `F11`	decrease volume
`None` + `F12`	increase volume
`None` + `XF86AudioMicMute`	un/mute microphone
`None` + `XF86AudioLowerVolume`	decrease volume
`None` + `XF86AudioRaiseVolume`	increase volume

Media

Keys	Action
`None` + `XF86AudioPlay`	play media
`None` + `XF86AudioPause`	pause media
`None` + `XF86AudioNext`	next media
`None` + `XF86AudioPrev`	previous media
`SUPER` + `CTRL` + `M`	un/mute the focused window

Brightness

Keys	Action
`None` + `XF86MonBrightnessUp`	increase brightness
`None` + `XF86MonBrightnessDown`	decrease brightness

Keys	Action
`SUPER` + `K`	toggle keyboard layout
`SUPER` + `ALT` + `G`	game mode
`SUPER` + `SHIFT` + `G`	game launcher

Screen Capture

Keys	Action
`SUPER` + `SHIFT` + `P`	color picker
`SUPER` + `P`	snip screen
`SUPER` + `CTRL` + `P`	freeze and snip screen
`SUPER` + `ALT` + `P`	print monitor
`None` + `Print`	print all monitors
`SUPER` + `CTRL` + `S`	scan text on screen

Keys	Action
`SUPER` + `ALT` + `Right`	next wallpaper
`SUPER` + `ALT` + `Left`	previous wallpaper
`SUPER` + `SHIFT` + `W`	select a wallpaper
`SUPER` + `ALT` + `Up`	next waybar layout
`SUPER` + `ALT` + `Down`	previous waybar layout
`SUPER` + `SHIFT` + `R`	wallbash mode selector
`SUPER` + `SHIFT` + `T`	select a theme
`SUPER` + `SHIFT` + `Y`	select animations
`SUPER` + `SHIFT` + `U`	select hyprlock layout

Keys	Action
`SUPER` + `1`	navigate to workspace 1
`SUPER` + `2`	navigate to workspace 2
`SUPER` + `3`	navigate to workspace 3
`SUPER` + `4`	navigate to workspace 4
`SUPER` + `5`	navigate to workspace 5
`SUPER` + `6`	navigate to workspace 6
`SUPER` + `7`	navigate to workspace 7
`SUPER` + `8`	navigate to workspace 8
`SUPER` + `9`	navigate to workspace 9
`SUPER` + `0`	navigate to workspace 10
`SUPER` + `KP_1` … `KP_0`	navigate to workspaces 11-20
`SUPER` + `CTRL` + `Down`	navigate to the nearest empty workspace
`SUPER` + `mouse_down`	next workspace
`SUPER` + `mouse_up`	previous workspace

The numpad binds work with Num Lock on or off: each key is bound under both keysyms it can emit.

Relative workspace

Keys	Action
`SUPER` + `CTRL` + `Right`	change active workspace forwards
`SUPER` + `CTRL` + `Left`	change active workspace backwards

Special workspace

Keys	Action
`SUPER` + `SHIFT` + `S`	move to scratchpad
`SUPER` + `ALT` + `S`	move to scratchpad (silent)
`SUPER` + `S`	toggle scratchpad

Move window silently

Keys	Action
`SUPER` + `ALT` + `1`	move to workspace 1 (silent)
`SUPER` + `ALT` + `2`	move to workspace 2 (silent)
`SUPER` + `ALT` + `3`	move to workspace 3 (silent)
`SUPER` + `ALT` + `4`	move to workspace 4 (silent)
`SUPER` + `ALT` + `5`	move to workspace 5 (silent)
`SUPER` + `ALT` + `6`	move to workspace 6 (silent)
`SUPER` + `ALT` + `7`	move to workspace 7 (silent)
`SUPER` + `ALT` + `8`	move to workspace 8 (silent)
`SUPER` + `ALT` + `9`	move to workspace 9 (silent)
`SUPER` + `ALT` + `0`	move to workspace 10 (silent)

Move window to workspace

Keys	Action
`SUPER` + `SHIFT` + `1`	move to workspace 1
`SUPER` + `SHIFT` + `2`	move to workspace 2
`SUPER` + `SHIFT` + `3`	move to workspace 3
`SUPER` + `SHIFT` + `4`	move to workspace 4
`SUPER` + `SHIFT` + `5`	move to workspace 5
`SUPER` + `SHIFT` + `6`	move to workspace 6
`SUPER` + `SHIFT` + `7`	move to workspace 7
`SUPER` + `SHIFT` + `8`	move to workspace 8
`SUPER` + `SHIFT` + `9`	move to workspace 9
`SUPER` + `SHIFT` + `0`	move to workspace 10
`SUPER` + `SHIFT` + `KP_1` … `KP_0`	move to workspaces 11-20

Keys	Action
`SUPER` + `ALT` + `CTRL` + `Right`	move window to next relative workspace
`SUPER` + `ALT` + `CTRL` + `Left`	move window to previous relative workspace

Your own keybindings go in:

~/.config/hypr/hyprland.lua

That file is yours — updates never overwrite it. HyDE's own binds live in ~/.local/share/hypr/lua/key_binds.lua, which is overwritten on every update, so edits there are lost. Your file loads after HyDE's binds, which is why anything you write there wins. The one thing loaded after it is your selected workflow, which can override compositor settings.

For example, to bind the HyDE Game Launcher to SUPER + Space:

hl.bind("SUPER + SPACE", hl.dsp.exec_cmd(hyde.sh.gamelauncher()), {
    description = "[Utilities] game launcher",
})

Add a description in the [Group|Subgroup] text shape and your bind shows up in the keybinding hint under that group. Without one it appears as a raw dispatcher call under "Misc".

hyde.sh.<name>() builds a hyde-shell command — here hyde-shell gamelauncher, the same thing you can run from a terminal. Some names are shortcuts for something longer: hyde.sh.screenshot.snip() is hyde-shell screenshot s, hyde.sh.menu.binds() is hyde-shell keybinds_hint. The full list is hyde.command_map in ~/.local/share/hypr/lua/hyde/dispatcher.lua.

Rebinding something HyDE already uses

Bind the same combination again and yours replaces it — but copy the flags too. A bind counts as the same one only when its flags match, and description is not a flag. Thirty-three of HyDE's binds carry one:

Flags	Binds
`locked`	media keys, mute, keyboard layout, game mode, and every screen-capture bind
`locked` and `repeating`	volume up and down, brightness up and down — on both the function row and the media keys
`repeating`	resize active window, move active window
`transparent`, and `release` on the apply step	the alt-tab switcher

Miss one and you end up with both binds firing on that combination.

So to move the mute key from F10 to F9, carry locked across:

hl.unbind("F10")
hl.bind("F9", hl.dsp.exec_cmd(hyde.sh.volumecontrol("-o", "m")), {
    locked = true,
    description = "[Hardware Controls|Audio] un/mute output",
})

hl.unbind takes the combination exactly as the bind was registered, with single spaces around each +. Copy the spelling from key_binds.lua rather than guessing: several binds are written there with CONTROL where you might expect CTRL. Rebinding is the safer route — HyDE replaces the old bind for you, so you never have to match a string.

Seeing your live keybindings

SUPER + / reads the binds from the compositor itself, so it shows your own alongside HyDE's and reflects whatever replaced a default. This table describes the shipped defaults only.

The list is cached, and the cache is refreshed when you close it — so right after adding a bind, the first press may still show the previous list. Press it twice, or run hyde-shell keybinds_hint --reload.

🡅

_{Last edited on: 30/07/2026}