Skip to content

Keybinds

Jump to bottom
P3DROVFX edited this page Oct 12, 2026 · 6 revisions

Keybinds

The fastest way to learn the keybinds is inside the shell itself: press Super + / to open the Cheat Sheet — its keybind view is generated live from the actual Hyprland configuration, so it's never out of date. This page covers the defaults and how the system works.

How keybinds are defined

ii-p3drovfx uses Hyprland's native Lua configuration: the entry point is ~/.config/hypr/hyprland.lua, and keybinds live in ~/.config/hypr/hyprland/keybinds.lua, declared through Hyprland's built-in hl API:

hl.bind("SUPER + Tab", hl.dsp.global("quickshell:overviewWorkspacesToggle"),
    { description = "Shell: Toggle overview" })

Each bind can carry a description — that's what the Cheat Sheet displays. Many shell binds come in pairs: a Quickshell global shortcut plus a fallback command (fuzzel, hyprshot, grim…) that runs when the shell isn't alive, so core actions keep working even if Quickshell is down.

To customize: don't edit hyprland/keybinds.lua (updates will overwrite it). Put your own binds in ~/.config/hypr/custom/keybinds.lua — it's loaded automatically after the defaults, along with custom/variables.lua, custom/general.lua, custom/rules.lua, custom/execs.lua and custom/env.lua.

Or don't touch a file at all: Settings → Hyprland → Shortcuts lists every bind on the system, says which file each one came from, and can change any of them — including the stock ones — writing the result into custom/keybinds.lua for you. See Hyprland Settings.

Requires Hyprland 0.56.1+ (the Lua config system is native Hyprland).

Shell surfaces

Keys Action
Super (tap) Toggle Search
Super + Tab Toggle workspace Overview
Super + A / B / O Toggle left sidebar (AI / policies)
Super + Alt + A Toggle left sidebar, detached
Super + N Toggle right sidebar (Dashboard)
Super + / Toggle Cheat Sheet
Super + Alt + N Toggle Notes
Super + Alt + C Open Search commands
Super + Shift + D Toggle dictation
Super + I Toggle Settings
Super + U Toggle app usage stats
Super + Y Toggle Modes & Routines manager
Super + K Toggle on-screen keyboard
Super + M Toggle media controls
Super + Z Toggle Media Mode
Super + G Toggle widget overlay
Super + J Toggle bar
Super + V Clipboard history
Super + . Emoji picker
Ctrl + Alt + Delete Session menu
Ctrl + Super + P Cycle panel family (ii → [[Tablet
Ctrl + Super + R Restart the shell
Shift + Super + Alt + / Toggle the welcome screen

Utilities

Keys Action
Super + Shift + E Edit desktop layout ([[Edit Mode
Super + Shift + S Screen snip (Region Selector)
Print Full-screen screenshot → clipboard
Ctrl + Print Full-screen screenshot → clipboard + file
Super + Shift + X OCR a region → clipboard
Super + Shift + T Translate screen content
Super + Shift + A Google Lens region search
Super + Shift + C Color picker
Super + Shift + R / Super + Alt + R Record region (no sound)
Ctrl + Alt + R Record fullscreen
Super + Shift + Alt + R Record fullscreen with sound
Super + Shift + V Toggle the [[Video Editor
Ctrl + Super + T Wallpaper selector
Ctrl + Super + Alt + T Random wallpaper
Ctrl + Super + Shift + D Toggle light/dark mode
Super + R OLED saver (blackout)
Super + − / Super + = Screen zoom out / in

Windows

Keys Action
Super + LMB drag Move window
Super + RMB drag Resize window
Super + ←/→/↑/↓ Focus in direction
Super + Shift + ←/→/↑/↓ Move window in direction
Super + Alt + ←/→/↑/↓ Quick-tile through Tiling Assistant zones (again at the edge to untile)
Super + Alt + Tab (+ Shift) Next / previous tiling layout
Alt + Tab (+ Shift) Window switcher — release Alt to switch, type to search, Alt + ` for the current app's windows ([[Tiling and Window Switcher
Super + Q Close window
Super + Shift + Alt + Q Force-kill window
Super + Alt + Space Toggle floating
Super + D Maximize
Super + F Fullscreen
Super + Alt + F Fullscreen spoof
Super + P Pin window
Super + ; / Super + ' Adjust split ratio
Super + Alt + S Toggle window to/from scratchpad

Workspaces

Keys Action
Super + 1…0 Focus workspace (raw keycodes — layout-independent, numpad included)
Super + Alt + 1…0 Silently send window to workspace
Ctrl + Super + ←/→ Focus workspace left/right
Super + Page Up/Down, Super + scroll Focus workspace left/right
Super + Shift + Page/scroll Move window to workspace left/right
Ctrl + Super + [ / ] Focus workspace left/right
Super + S Toggle scratchpad (special workspace)
Ctrl + Super + C Workspace Compactor: squash occupied workspaces into 1..N

In the Cheat Sheet's Workspaces tab: Ctrl + 1…9 restores a Workspace Profile, Ctrl + Alt + N deletes one.

Session, media & apps

Keys Action
Super + L Lock
Super + Shift + L Suspend
Ctrl + Shift + Alt + Super + Delete Power off
Super + Shift + P Play/pause
Super + Shift + N / B Next / previous track
Super + Shift + M Mute output
Super + Alt + M Mute microphone
Super + Return / T Terminal
Super + E File manager
Super + W Browser
Super + C Code editor
Super + X Text editor
Ctrl + Shift + Escape Task manager
Super + Space Switch keyboard layout

Hardware keys (brightness, volume, media) are bound with locked = true, so they keep working on the lock screen.

Extras worth knowing

  • Virtual machine submap — Super + Alt + F1 disables all keybinds (so a VM can have them) and re-enables on the same combo.
  • AI text summary — Super + Shift + Alt + right-click summarizes the selected text via a local Ollama model.
  • Number keys use raw keycodes, so workspace switching works on any keyboard layout (AZERTY included).
  • In-app shortcuts (screenshot editor undo/redo, Dashboard tab cycling, profile restore, the Notes editor, the Typing test…) are documented on each feature's page.
  • The Tablet family registers extra global shortcuts you can bind yourself — appDrawerToggle, recentsToggle — and the Notes app registers notesToggle, notesOpen and notesClose.
  • Inside Search, Ctrl + K on a result lets you give it a Ctrl + letter keybind or an alias — see Launcher & Search.

Related pages

← Back to Home

Clone this wiki locally