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.

Environment variables exported to apps launched by Halley.

Commands Halley runs on compositor startup or config reload.

Cursor theme, size, and idle/typing visibility settings.

Keyboard repeat behavior, focus policy, keyboard layout, gestures, and libinput device settings.

Font used by Halley labels and overlays.

Screenshot output directory and capture overlay colors.

Optional compositor diagnostics for troubleshooting and tuning.

Monitor viewport settings, output connector blocks, and focus-ring defaults.

Compositor background renderer: solid fill, classic image, or spatial field shader.

Field spacing, active-window limits, pinned badge styling, close restore, and zoom settings.

Expanded window spawn placement, landmark blocker handling, and reveal panning.

Collapsed node appearance, labels, icons, and click behavior.

Timing for active, inactive, and offscreen docked window decay.

Recent-focus history behavior.

Directional orientation overlay display settings.

aperture-peek 8

Standalone Aperture clock panel styling used by the compositor reserve/peek integration.

Cluster dwell timing, spread, bloom direction, and default layout.

Tiling layout gaps, stack depth, and queued-window icon behavior.

Stacking layout visibility limits.

Physics-style motion smoothing settings.

Gamescope launch defaults and per-game profile overrides.

animations 38

Master animation defaults and nested animation blocks.

Backdrop blur policy and renderer-level shadow settings.

decorations 12

Primary and secondary borders plus border-driven resize behavior.

Overlay color, shape, and border styling.

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

Window rule blocks and individual matching/placement policy options.