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.debug Optional compositor diagnostics for troubleshooting and tuning.viewport Monitor viewport settings, output connector blocks, and focus-ring defaults.field Field spacing, active-window limits, pinned badge styling, close restore, and zoom settings.placement Expanded window spawn placement, landmark blocker handling, and reveal panning.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.gamescope Gamescope launch defaults and per-game profile overrides.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 Fresh-config keybind defaults, chord mapping syntax, and built-in action keywords.rules Window rule blocks and individual matching/placement policy options.