Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Keybindings

Press Super + / inside dwm to open a live, searchable Quickshell keybind viewer.

MODKEY = Super (Windows key) in the shipped config.h.

Bindings are defined in config/hotkeys.toml and reload instantly on save — no recompile needed.


Launchers

KeysAction
Super + RApp launcher (Quickshell)
Super + OWindow overview: every window on every tag (Getting Started)
Super + XAlacritty terminal
Super + EFile manager
Super + BBrowser
Super + /Keybind viewer
Super + F1Control Center
Super + Shift + RRestart Quickshell

Screenshots

KeysAction
Super + PScreenshot active monitor (cursor omitted)
Super + Shift + PScreenshot selection → file
Super + Ctrl + PScreenshot selection → clipboard

All dwm-screenshot capture modes omit the mouse cursor. maim region captures start selection immediately without a monitor chooser. The active-monitor shortcut uses the monitor under the pointer. Clipboard captures are PNG selections owned by xclip, while captures saved to disk use JPEG. The lightweight capture flow intentionally has no annotation toolbar.

Applications and Web Apps

KeysAction
Super + AChatGPT
Super + Shift + AGemini
Super + Shift + XX/Twitter — new post

Super + A opens an installed ChatGPT desktop application when one is available and falls back to the ChatGPT web app otherwise. The application launcher hides the ChatGPT web entry while a native desktop entry is installed.

Window Management

KeysAction
Super + JFocus next window
Super + KFocus previous window
Super + Shift + JMove window down in stack
Super + Shift + KMove window up in stack
Super + ReturnPromote window to master
Super + QClose window
Super + IAdd window to master area
Super + DRemove window from master area
Super + HShrink master area
Super + LExpand master area
Super + Shift + HIncrease window cfact size
Super + Shift + LDecrease window cfact size
Super + Shift + OReset window cfact

Layouts

KeysAction
Super + TTiling layout
Super + FFloating layout
Super + MFullscreen the focused window (not a layout)
Super + SpaceToggle floating for window
Super + Shift + MToggle floating for window
Super + Shift + YFake fullscreen (bar stays)
Super + Shift + BToggle bar visibility

The monocle layout (one window at a time, the bar visible) has no default key: choose it in the Control Center’s Window layout row.

Floating a tiled window with Super + Space (or Super + Shift + M, or Super + Middle click) pops it out of its tile at 85 percent of the tile’s size, centered on it and kept inside the work area, so the change is visible. A window whose minimum size is larger than the work area keeps that size, starting at the work area’s top-left corner and extending past it. Toggle again to return it to the tile. Super + F applies the same shrink to each visible tiled window when it switches to the floating layout, including from monocle, and Super + T retiles them. Choosing the floating layout again leaves the sizes alone, and windows already floated individually keep their size and position. Fixed-size windows are never resized. Mouse dragging and resizing keep the geometry they start from.

Tags (Workspaces)

KeysAction
Super + 1–9Switch to tag
Super + Ctrl + 1–9Also show tag alongside current
Super + Shift + 1–9Move window to tag
Super + Ctrl + Shift + 1–9Also show window on that tag
Super + 0Show windows from all nine tags; 0 is not a tag
Super + TabPrevious tag

Multi-Monitor

KeysAction
Super + ,Focus left monitor
Super + .Focus right monitor
Super + Shift + ,Send window to left monitor
Super + Shift + .Send window to right monitor

Media Keys

KeysAction
XF86AudioRaiseVolumeVolume up
XF86AudioLowerVolumeVolume down
XF86AudioMuteMute toggle
XF86MonBrightnessUpBrightness up
XF86MonBrightnessDownBrightness down

Session & Power

KeysAction
Super + Ctrl + QPower menu
Super + Shift + QLog out: opens the power menu at its confirmation
Super + Ctrl + Shift + QQuit dwm at once, without asking; for when the shell is not running
Super + Ctrl + Shift + RReboot: opens the power menu at its confirmation
Super + Ctrl + Shift + SSuspend

Mouse

ActionFunction
Super + Left dragMove window
Super + Middle clickToggle floating
Super + Right dragResize window

Customizing Keybinds

Edit config/hotkeys.toml — changes take effect on save, no recompile required.

[vars]
terminal = "alacritty"

keys = [
  { mod="SUPER SHIFT", key="f", desc="Firefox", func="spawn", exec=["firefox"] },
]

See the comments in hotkeys.toml for a full list of func values and modifier syntax.

The browser binding uses dwm-default-apps open. Configure it with Settings -> Defaults or with dwm-default-apps browsers and dwm-default-apps set-browser <desktop-id>.

The terminal variable defaults to Alacritty. Settings -> Defaults can select a validated installed terminal without changing the Super+X key record. To use the optional Herdr workspace, install it explicitly, change the binding to dwm-terminal, and set DWM_HERDR=1 in the session environment.