Keybindings

Chord syntax

A binding is a chord string mapped to a semantic command:

bind "M-S-j" SwapNext

Modifiers, always in the order M C A S:

Keys — you can bind any key:

• letters a–z, digits 0–9;
• named keys: Return, space, Tab, Escape, BackSpace, Delete, Insert, comma, period, minus, equal, plus, arrows (Left/Right/Up/Down), navigation (Home, End, PageUp, PageDown, Print, Menu), function keys F1–F24, and punctuation (slash, backslash, semicolon, apostrophe, bracketleft, bracketright, grave);
• anything else by its raw xkb keysym in lowercase hex — e.g. bind "0x1008ff14" (Spawn "playerctl play-pause") for XF86AudioPlay. Find a key's name or keysym by running wev (or xev) and pressing it.

bind "Print"        screenshotArea
bind "M-F1"         (Spawn "kitty -e man wtf")
bind "0x1008ff14"   (Spawn "playerctl play-pause")   // XF86AudioPlay by raw keysym

Only bare modifier presses (Super, Shift, …) and dead keys aren't bindable on their own. Note: the volume/mute/brightness XF86Audio* keys are already handled by the WM (they drive the MPRIS player / wpctl), so binding those is redundant.

Bindings are resolved against xkb group 0 (your first layout), so they keep working while you're typing in a second layout — M-j is M-j even when the active layout is Russian.

The default map

These are the built-in defaults (also active in safe mode). Your config.fsx keys block replaces this map, so copy what you want to keep.

Launch & close

Focus & stack

Spatial (directional) navigation — focus or move by screen direction (the nearest tile left/right/up/down, computed from the live layout geometry), not by stack order. Handy on arrow keys:

bind "M-Left"  focusLeft    // = Focus (InDir DirLeft)
bind "M-Right" focusRight
bind "M-Up"    focusUp
bind "M-Down"  focusDown
bind "M-S-Left"  swapLeft   // = SwapDir DirLeft — move the focused window there
bind "M-S-Right" swapRight

SwapWith n swaps the focused window with window n directly (the primitive behind pick-a-tile swapping); SwapDir is SwapWith aimed by direction.

Swap mode (COSMIC-style, default M-x) — a modal way to swap the focused window with any tile you pick:

bind "M-x" swapMode     // = SwapMode

Press it, and the focused window becomes the "source". Arrow keys (or h/j/k/l) move a highlighted selection across the layout; Return swaps source↔selection, Escape cancels. While the mode is active every key is captured. (You can also enter it over the socket: wtfctl swap-mode.)

Mouse: drag a tile to swap — hold Super (the default mod) and left-drag a tiled window. It follows the pointer as a ghost; drop it on another tile and the two swap (dropping on empty space or itself does nothing). The layout is untouched until you release — no window collapses mid-drag. This is the pointer equivalent of swap mode: same SwapWith under the hood, the target sourced from where you drop instead of the arrow keys. (Floating windows are moved the normal way, by their own title bar / client drag — that path is unchanged.)

Layouts

Workspaces

Session & history

Singleton launches: once

Mashing a launcher key shouldn't stack ten launchers. Wrap any Spawn in once and a new instance starts only if the previous one has exited:

bind "M-p" (once (Spawn "wtf-omnibox"))

The full command vocabulary

Anything bindable is also scriptable via wtfctl. Commands:

Focus (NextWindow|PrevWindow|ByApp "x"|ById n|InDir DirLeft|…|Focused) · FocusMaster · SwapNext · SwapPrev · SwapMaster · SwapWith n · SwapDir (DirLeft|DirRight|DirUp|DirDown) · ToggleFloat · ToggleFullscreen · SinkAll · CloseFocused · Spawn cmd · SpawnOnce cmd · SwitchWorkspace tag · MoveToWorkspace tag · NextWorkspace · PrevWorkspace · SetLayout name · NextLayout · SetWorkspaceType name · SetWorkspaceState data · SetMaster n · IncMaster · DecMaster · SetRatio f · SetGaps n · IncGaps · DecGaps · SetInactiveOpacity f · SetAnimationSpeed f · SetBorderWidth n · SetBorderColor … · SetCornerRadius n · SetBlur b · Undo · Redo · SaveSession · LoadSession · ReloadConfig

Found a problem on this page? Edit it on GitHub — the site rebuilds from docs/ automatically.