Config Reference

Config Sections

Canonical hyphenated option names accepted by Halley's config loader. Each section has its own page with types, builtin defaults, and notes.

Split configs reload together. The watcher follows nested Rune gather dependencies and rebuilds the watched file set after every accepted reload.
env 1
Environment variables exported to apps launched by Halley.
autostart 7
Startup/reload commands and optional named startup clusters.
cursor 7
Cursor theme, logical size, and independent visibility policies.
input 51
Keyboard, pointer focus, gestures, physical device classes, touch, and exact-name overrides.
font 2
Font used by Halley labels and overlays.
screenshot 1
Destination for native and portal PNG captures.
debug 2
Optional focus-ring and per-output FPS diagnostics.
view 13
Repeated per-output hardware and focus-ring policy. The stable page URL is retained from older releases.
wallpaper 8
Plain black, classic image, or spatial field-shader wallpaper.
field 14
Shared Field clearance, pin badges, close-focus restoration, and outward-only zoom.
placement 2
Landmark placement compatibility retained by the 0.6 config shape.
node 10
Collapsed-node shape, labels, icons, fill, independent border colors, and restore panning.
decay 3
Automatic collapse timing inside and outside the focus ring.
trail 2
Recent-focus history behavior.
bearings 5
Directional orientation overlay display settings.
clusters 12
Cluster creation, bloom joining, and nested tiling/stacking layout defaults.
apogee 7
Multi-monitor overview layout, preview, transition, and dimming policy.
physics 2
Physics-style motion smoothing settings.
animations 46
Window, fullscreen, maximize, resize, reversible arrangement, node, and cluster motion.
effects 11
Backdrop quality for compositor overlays and renderer-level shadow layers.
decorations 24
Managed borders, border resize, and compositor-owned titlebars with independent text sizing.
overlays 26
Independent compositor-overlay palette, borders, geometry, notifications, and zoom-indicator overrides.
keybinds 24
Required chord map with exact modifiers, optional repeat overrides, and context scopes.
rules 26
Window matching, optional rule composition, opening behavior, appearance and separate capture privacy.