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.

env Environment variables exported to apps launched by Halley.autostart Commands Halley runs on compositor startup or config reload.cursor Cursor theme, size, and idle/typing visibility settings.input Keyboard repeat behavior, focus policy, and keyboard layout settings.font Font used by Halley labels and overlays.screenshot Screenshot output directory and capture overlay colors.viewport Monitor viewport settings, output connector blocks, and focus-ring defaults.field Camera, spacing, active-window, and field zoom settings.field.zoom Zoom controls, limits, and smoothing for the field camera.node Collapsed node appearance, labels, icons, and click behavior.decay Timing for active, inactive, and offscreen docked window decay.trail Recent-focus history behavior.bearings Directional orientation overlay display settings.clusters Cluster dwell timing, spread, bloom direction, and default layout.tile Tiling layout gaps, stack depth, and queued-window icon behavior.stacking Stacking layout visibility limits.physics Physics-style motion smoothing settings.animations Master animation defaults and nested animation blocks.decorations Primary and secondary borders, compositor-drawn shadows, and border-driven resize behavior.overlays Overlay color, shape, and border styling.keybinds Modifier token and chord-to-action mappings.rules Window rule blocks and individual matching/placement policy options.