ReferenceUpdated with the current release

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

Keys Action
Super + R App launcher (Quickshell)
Super + X Alacritty terminal
Super + E File manager
Super + V Clipboard history (capture and disk persistence are separate opt-ins)
Super + B Browser
Super + W Looking Glass VM client (when installed)
Super + Shift + W Randomize wallpaper
Super + / Keybind viewer
Super + F1 Control Center
Super + Alt + F1 Control Center (alternate)
Super + Shift + R Restart Quickshell
Super + Ctrl + R Force-stop Steam, Wine/Proton, and Windows applications

Super + Ctrl + R force-kills matching processes without relaunching them. Unsaved application or game progress can be lost.

Screenshots

Keys Action
Super + P Screenshot active monitor (cursor omitted)
Super + Shift + P Screenshot selection → file
Super + Ctrl + P Screenshot 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

Keys Action
Super + A ChatGPT
Super + Shift + A Gemini
Super + Shift + X X/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. Existing systems with the former stock web-app binding receive the same native-first behavior through the updated webapp-launch helper. Upgrades do not edit customized hotkey files.

Window Management

Keys Action
Super + J Focus next window
Super + K Focus previous window
Super + Shift + J Move window down in stack
Super + Shift + K Move window up in stack
Super + Return Promote window to master
Super + Q Close window
Super + I Add window to master area
Super + D Remove window from master area
Super + H Shrink master area
Super + L Expand master area
Super + Shift + H Increase window cfact size
Super + Shift + L Decrease window cfact size
Super + Shift + O Reset window cfact

Layouts

Keys Action
Super + T Tiling layout
Super + F Floating layout
Super + M Toggle monocle focus mode and bar
Super + Space Toggle floating for window
Super + Shift + M Toggle floating for window
Super + Shift + Y Fake fullscreen (bar stays)
Super + Shift + B Toggle bar visibility

Super + M switches to the monocle layout and toggles the bar. It does not request per-window fullscreen; applications or window rules do that when needed. The saved pre-focus layout is shared across tags and monitors, so switching tags before pressing the binding again may restore a different layout. The monocle layout has no separate direct layout binding. To select it directly, add a setlayout record with layout_idx=2 to hotkeys.toml.

Entering floating mode with a toggle shrinks a tiled window by 15% around its current center, subject to the application’s minimum size and resize increments. Toggle again to return it to the tiling layout. Super + F applies the same shrink to each visible tiled window when entering floating layout; Super + T retiles them. Pressing Super + F again leaves their sizes unchanged. Windows already floated individually keep their size and position. Mouse dragging and resizing keep their existing behavior. Existing hotkey configuration needs no changes; restart the dwm session after updating to activate this behavior.

Tags (Workspaces)

Keys Action
Super + 1–9 Switch to tag
Super + Ctrl + 1–9 Also show tag alongside current
Super + Shift + 1–9 Move window to tag
Super + Ctrl + Shift + 1–9 Also show window on that tag
Super + 0 Show windows from all nine tags; 0 is not a tag
Super + Tab Toggle window overview across all tags

Multi-Monitor

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

Media Keys

Keys Action
XF86AudioRaiseVolume Volume up
XF86AudioLowerVolume Volume down
XF86AudioMute Mute toggle
XF86MonBrightnessUp Brightness up
XF86MonBrightnessDown Brightness down

Session & Power

Keys Action
Super + Ctrl + Q Power menu
Super + Shift + Q Quit dwm and cleanly end the graphical session
Super + Ctrl + Shift + R Reboot
Super + Ctrl + Shift + S Suspend

Mouse

Action Function
Super + Left drag Move window
Super + Right drag Resize window

Middle click is unbound by default. To use it, add a button=2 record to the buttons array in hotkeys.toml.


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.

Keyboard layouts

Set two or more layouts in Settings -> Input -> Keyboard layout (for example us,gr). Keep a Latin layout first: dwm matches hotkeys against the first layout’s keys. To switch with a key, pick one under Settings -> Input -> Switch layout with (Alt+Shift, Caps Lock, …), or type any grp: option into Modifier options. Avoid the Space chords such as grp:win_space_toggle: XKB switches the layout and dwm still runs Super+Space (toggle floating). To switch with a dwm hotkey instead, bind the cyclelayout func; there is no default binding:

{ mod="SUPER ALT", key="k", desc="Next keyboard layout", func="cyclelayout", i=1 },

Settings sets the layout on that keyboard only. X copies it to the shared keyboard state, which dwm and the panel read, right away if that keyboard was the last one used, otherwise on its next key press. Until then the panel can show the old layout; switching works normally after that.

dwm publishes the active layout on the root window, so xprop -root _DWM_KEYBOARD_GROUP shows the current group and the group count, and dwm-quickshell-state keyboard-group next switches from a script.

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.

Clipboard capture is off by default. Open Super+V and choose Enable; discard older history to start capturing new copies through the sensitivity backend. This deletes older clipboard history without importing it. Persist is a separate opt-in; disabling capture clears both memory and stored history. Clear all also discards older history and restarts observation without importing the current clipboard.

Browser and terminal copies remain available. Recognized password-manager sources and sensitivity-marked copies are excluded on a best-effort basis. An unmarked copy made by a browser extension cannot reliably be distinguished from ordinary browser text, so it may enter history. Do not enable capture when that limitation is unacceptable. Backend failure stops capture until an explicit retry.

On upgrade, migration preserves any existing v binding regardless of its modifier. SUPER follows the locally compiled MODKEY, which may differ from the stock Super key. If migration reports a V conflict, keep the existing action or add the Clipboard history command manually with a free modifier combination.