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 0.6 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 2
Commands Halley runs on compositor startup or config reload.
cursor 6
Cursor theme, logical size, and independent visibility policies.
input 49
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 12
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 33
Window, fullscreen, maximize, resize, node, and cluster motion.
effects 11
Backdrop quality for compositor overlays and renderer-level shadow layers.
decorations 21
Managed borders, border resize, and compositor-owned titlebars with the 0.7 neutral-and-orange defaults.
overlays 24
Independent compositor-overlay palette, borders, geometry, notifications, and zoom-indicator overrides.
keybinds 17
Required chord map with exact modifiers, optional repeat overrides, and context scopes.
rules 12
Strict first-match policy for managed windows and layer-shell surfaces.