Config Reference

`Keybinds`

Fresh-config keybind defaults, chord mapping syntax, and built-in action keywords.

Defaults

Defaults shown here are the effective builtin defaults from RuntimeTuning::builtin_defaults().

Default Config Shape

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

keybinds:
  mod "super"

  # Basic compositor controls.
  "$var.mod+shift+r" "reload"
  "$var.mod+n" "toggle-state"
  "$var.mod+m" "maximize-focused"
  "$var.mod+f" "toggle-fullscreen"
  "$var.mod+p" "toggle-focused-pin"
  "$var.mod+q" "close-focused"

  # Zoom controls for the field camera.
  "$var.mod+mousewheelup" "zoom-in"
  "$var.mod+mousewheeldown" "zoom-out"
  "$var.mod+middlemouse" "zoom-reset"

  "$var.mod+shift+e" "quit"

  # Move the selected/latest node in the field.
  "$var.mod+left" "node-move left"
  "$var.mod+right" "node-move right"
  "$var.mod+up" "node-move up"
  "$var.mod+down" "node-move down"

  # Switch active monitor focus.
  "$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"

  # Cluster controls.
  "$var.mod+shift+c" "cluster-mode"
  "$var.mod+l" "cluster-layout cycle"
  "$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"

  # Bearings controls.
  "$var.mod+z" "bearings-show"
  "$var.mod+shift+z" "bearings-toggle"

  # Trail navigation.
  "$var.mod+," "trail-prev"
  "$var.mod+." "trail-next"

  # Focus cycling.
  "alt+tab" "cycle-focus"
  "alt+shift+tab" "cycle-focus-backward"

  # Applications.
  "$var.mod+return" "open-terminal"
  "$var.mod+d" "fuzzel"

  # Mouse actions.
  "$var.mod+leftmouse" "move-window"
  "$var.mod+rightmouse" "resize-window"
  "$var.mod+shift+leftmouse" "pan-field"

  # Tile layout controls.
  "$var.mod+left" "tile-focus left"
  "$var.mod+right" "tile-focus right"
  "$var.mod+up" "tile-focus up"
  "$var.mod+down" "tile-focus down"

  "$var.mod+ctrl+left" "tile-swap left"
  "$var.mod+ctrl+right" "tile-swap right"
  "$var.mod+ctrl+up" "tile-swap up"
  "$var.mod+ctrl+down" "tile-swap down"

  # Stacking layout controls.
  "$var.mod+left" "stack-cycle forward"
  "$var.mod+right" "stack-cycle backward"

  # Screenshot UI.
  "$var.mod+shift+s" "halleyctl capture menu"

  # Media keys.
  "XF86AudioRaiseVolume" "wpctl set-volume -l 1 @default_audio_sink@ 5%+"
  "XF86AudioLowerVolume" "wpctl set-volume @default_audio_sink@ 5%-"
  "XF86AudioMute" "wpctl set-mute @default_audio_sink@ toggle"
end

`keybinds`

Modifier token and chord-to-action mappings. The 0.4.0 example mirrors the shipped fresh-config defaults.

Option	Type	Default	Notes
`mod`	modifier token	`super`	Base modifier token used by $var.mod and $mod.
`<chord>`	action string	`fresh-config bindings`	Any additional entry maps a chord such as $var.mod+return, alt+tab, or $var.mod+1 to an action string. v0.2.0 adds defaults for maximize-focused, cycle-focus, cycle-focus-backward, and cluster slot 1 through 10; v0.3.0 adds toggle-focused-pin; v0.4.0 adds toggle-fullscreen.

`action keywords`

Action strings parsed by Halley before falling back to launching a command.

Option	Type	Default	Notes
`reload`	global action	`builtin`	Reloads the active config.
`open-terminal`	global action	`builtin`	Opens the first supported Wayland terminal found in PATH. Alias: open_terminal.
`toggle-state`	global action	`builtin`	Toggles the focused window state. Aliases: toggle_state, minimize-focused, minimize_focused.
`maximize-focused`	field action	`builtin`	Toggles monitor-local maximize for the focused field window. Aliases: maximize_focused, toggle-maximize, toggle_maximize.
`toggle-fullscreen`	field action	`builtin`	Toggles compositor-initiated fullscreen for the focused window. Aliases: toggle_fullscreen, fullscreen.
`toggle-focused-pin`	field action	`builtin`	Pins or unpins the focused window. Aliases: toggle-pin, toggle_pin, pin-toggle, pin_toggle, toggle_focused_pin.
`close-focused`	global action	`builtin`	Closes the focused window. Aliases: close_focused, close-window, close_window.
`quit`	global action	`builtin`	Quits Halley. The default binding includes Shift.
`zoom-in`	global action	`builtin`	Zooms the field camera in. Alias: zoom_in.
`zoom-out`	global action	`builtin`	Zooms the field camera out. Alias: zoom_out.
`zoom-reset`	global action	`builtin`	Resets field zoom. Alias: zoom_reset.
`node-move <dir>`	field action	`builtin`	Moves the selected/latest field node. Directions: left, right, up, down. Legacy aliases: move-left, move-right, move-up, move-down.
`monitor-focus <dir\|output>`	global action	`builtin`	Focuses a monitor by direction or output name. Directions: left, right, up, down. Alias: monitor_focus.
`cluster-mode`	global action	`builtin`	Enters cluster mode. Alias: cluster_mode.
`cluster-layout cycle`	cluster action	`builtin`	Cycles cluster layout. Accepted forms include cluster layout cycle and cluster_layout cycle.
`cluster slot <1-10>`	global action	`builtin`	Activates a per-monitor cluster slot. Accepted forms include cluster-slot N and cluster_slot N.
`cycle-focus`	global action	`builtin`	Cycles focus forward. Aliases: cycle_focus, focus-cycle, focus_cycle.
`cycle-focus-backward`	global action	`builtin`	Cycles focus backward. Aliases: cycle_focus_backward, focus-cycle-backward, focus_cycle_backward.
`bearings-show`	global action	`builtin`	Shows bearings while the binding is active. Alias: bearings_show.
`bearings-toggle`	global action	`builtin`	Toggles persistent bearings. Alias: bearings_toggle.
`trail-prev`	global action	`builtin`	Moves to the previous trail entry. Aliases: trail_prev, trail prev.
`trail-next`	global action	`builtin`	Moves to the next trail entry. Aliases: trail_next, trail next.
`tile-focus <dir>`	tile action	`builtin`	Focuses a tile in the given direction. Alias forms: tile_focus <dir>, tile focus <dir>.
`tile-swap <dir>`	tile action	`builtin`	Swaps a tile in the given direction. Alias forms: tile_swap <dir>, tile swap <dir>.
`stack-cycle <dir>`	stack action	`builtin`	Cycles a stack. Directions: forward, next, backward, back, prev, previous. Alias: stack_cycle.
`move-window`	pointer action	`builtin`	Moves a window when used with a pointer button chord. Alias: move_window.
`resize-window`	pointer action	`builtin`	Resizes a window when used with a pointer button chord. Alias: resize_window.
`pan-field`	pointer action	`builtin`	Pans the field when used with a pointer button chord. Aliases: pan_field, drag-pan, drag_pan, field-jump, field_jump.
`<command>`	launch command	`fallback`	Any unrecognized action string is treated as a command to launch, so fuzzel, halleyctl capture menu, wpctl commands, and spawn-style shell commands are valid.