Config Reference

`Keybinds`

Required chord map with exact modifiers, optional repeat overrides, and context scopes.

Defaults

Defaults shown here are the effective built-in defaults for the selected wiki version.

Default Config Shape

Use this as the section shape when editing halley.rune.

keybinds:
  mod "super"
  "$var.mod+shift+e" "quit"
  "$var.mod+q" "close-focused"
  "$var.mod+f" "toggle-fullscreen"
  "$var.mod+m" "maximize-focused"
  "$var.mod+n" "toggle-state"
  "$var.mod+p" "toggle-focused-pin"
  "$var.mod+o" "apogee"
  "$var.mod+z" "bearings-show"
  "$var.mod+shift+z" "bearings-toggle"
  "alt+tab" "cycle-focus"
  "alt+shift+tab" "cycle-focus-backward"
  "$var.mod+h" "center-last-focused"
  "$var.mod+shift+left" "monitor-focus left"
  "$var.mod+shift+right" "monitor-focus right"
  "$var.mod+shift+up" "monitor-focus up"
  "$var.mod+shift+down" "monitor-focus down"
  "$var.mod+shift+c" "cluster-mode"
  "$var.mod+l" "cluster-layout-cycle"
  "$var.mod+v" "cluster-toggle-float"
  "$var.mod+1" "cluster-slot-1"
  "$var.mod+2" "cluster-slot-2"
  "$var.mod+3" "cluster-slot-3"
  "$var.mod+4" "cluster-slot-4"
  "$var.mod+5" "cluster-slot-5"
  "$var.mod+6" "cluster-slot-6"
  "$var.mod+7" "cluster-slot-7"
  "$var.mod+8" "cluster-slot-8"
  "$var.mod+9" "cluster-slot-9"
  "$var.mod+0" "cluster-slot-10"
  "$var.mod+left" "focus-left"
  "$var.mod+right" "focus-right"
  "$var.mod+up" "focus-up"
  "$var.mod+down" "focus-down"
  "$var.mod+comma" "trail-prev"
  "$var.mod+period" "trail-next"
  "$var.mod+alt+left" "node-move left"
  "$var.mod+alt+right" "node-move right"
  "$var.mod+alt+up" "node-move up"
  "$var.mod+alt+down" "node-move down"
  "$var.mod+alt+shift+left" "window-transfer left"
  "$var.mod+alt+shift+right" "window-transfer right"
  "$var.mod+alt+shift+up" "window-transfer up"
  "$var.mod+alt+shift+down" "window-transfer down"
  "$var.mod+ctrl+left" "cluster-tile-swap-left" with scope "tile"
  "$var.mod+ctrl+right" "cluster-tile-swap-right" with scope "tile"
  "$var.mod+ctrl+up" "cluster-tile-swap-up" with scope "tile"
  "$var.mod+ctrl+down" "cluster-tile-swap-down" with scope "tile"
  "$var.mod+ctrl+left" "resize-window-left" with scope "field"
  "$var.mod+ctrl+right" "resize-window-right" with scope "field"
  "$var.mod+ctrl+up" "resize-window-up" with scope "field"
  "$var.mod+ctrl+down" "resize-window-down" with scope "field"
  "$var.mod+a" "arrange-visible"
  "$var.mod+shift+r" "reload"
  "$var.mod+t" "default-terminal"
  "$var.mod+d" "halley-lift"
  "XF86AudioRaiseVolume" "wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%+ --limit 1.0" with repeat true
  "XF86AudioLowerVolume" "wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%-" with repeat true
  "XF86AudioMute" "wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle"
  "$var.mod+minus" "zoom-out"
  "$var.mod+equal" "zoom-in"
  "$var.mod+shift+0" "zoom-reset"
  "Print" "screenshot"
  "$var.mod+click-left" "move-window"
  "$var.mod+click-right" "resize-window"
  "$var.mod+shift+click-left" "drag-pan"
  "click-left" "pan-field"
end

`keybinds`

Keyboard, pointer-button, and physical-wheel triggers.

Option	Type	Default	Notes
`mod`	modifier	`super`	Base modifier; generic or exact left/right super, alt, ctrl, or shift.
`<chord> <action>`	binding	`fresh config`	Exact modifier matching; unrecognized actions launch commands.
`with repeat true\|false`	binding attribute	`action default`	Overrides held-key repeat.
`with scope global\|field\|cluster\|tile\|stack`	binding attribute	`action default`	Allows duplicate chords in non-overlapping contexts.
`click-* \| scroll-* \| keycode-* \| button-*`	physical triggers	`none`	Pointer, wheel, and numeric evdev trigger forms.

`built-in actions`

Actions parsed before command fallback.

Option	Type	Default	Notes
`quit \| close-focused \| reload \| screenshot`	global actions	`builtin`	Session, close, reload, and native capture actions.
`toggle-fullscreen \| maximize-focused \| toggle-state \| toggle-focused-pin`	window actions	`builtin`	Focused-window state actions.
`focus-<direction> \| cycle-focus \| cycle-focus-backward`	navigation	`builtin`	Contextual direction and MRU navigation.
`trail-prev \| trail-next \| center-last-focused`	Field navigation	`builtin`	Per-output history and Field centering.
`node-move <direction> \| resize-window-<direction>`	Field actions	`builtin`	Moves a node or resizes a Field window.
`monitor-focus <direction\|output>`	global action	`builtin`	Focuses an adjacent or exact named output.
`cluster-mode \| cluster-layout-cycle \| cluster-slot-<1-10>`	cluster actions	`builtin`	Creates, lays out, and activates clusters.
`cluster-toggle-float \| cluster-tile-swap-<direction>`	cluster actions	`builtin`	Floats a member or reorders a tiling layout.
`apogee \| bearings-show \| bearings-toggle`	overlay actions	`builtin`	Spatial overview and navigation overlays.
`move-window \| resize-window \| pan-field`	pointer actions	`builtin`	Remappable compositor grabs.
`zoom-in \| zoom-out \| zoom-reset \| default-terminal`	global actions	`builtin`	Camera zoom and terminal launch.
`<command>`	command line	`fallback`	Any non-built-in action is launched as a command.
`close-focused`	action	`Mod+Q`	Close the focused window. In an empty active cluster, two released presses delete only the cluster; Escape cancels, and launchers or new members clear confirmation.
`arrange-visible`	action	`Mod+A`	Toggle a reversible, monitor-local Field mosaic. An untouched arrangement restores its saved geometry, including during animation. Moving, resizing, transferring or closing a participant ends that snapshot; the next invocation arranges the current windows.
`window-transfer <direction>`	action	`Mod+Alt+Shift+Arrow`	Transfer the focused Field window to the neighboring monitor.
`pan-field <direction>`	action	`unbound`	Pan the Field through an optional keyboard action.
`drag-pan`	pointer action	`Mod+Shift+left-drag`	Carry a grabbed window through its output's Field by dwelling at the output edge.
`pan-field-always`	pointer action	`unbound`	Pan from over applications, titlebars, nodes or wallpaper. Use a modified pointer chord. Respects camera owners, overlays and pointer constraints.
`node-move <direction> <distance>`	action	`unbound`	Move by a chosen number of Field units, stopping at landmark obstructions. Ordinary movement bindings retain their default distance.