Config Reference

`Overlays`

Independent compositor-overlay palette, borders, geometry, notifications, and zoom-indicator overrides.

Defaults

Defaults shown here are the effective built-in defaults for the selected wiki version.

Default Config Shape

Use this as the section shape when editing halley.rune.

overlays:
  background-colour "auto"
  text-colour "auto"
  error-colour "#fb4934"
  border-colour "#d65d26"
  radius 8
  borders true
  border-size 3
  notifications:
    position "top-center"
    success-duration-ms 4000
    error-duration-ms 9000
  end
  zoom-indicator:
    enabled true
    position "bottom-center"
    hold-duration-ms 750
    fade-duration-ms 180
    background true
    opacity 1.0

    # Optional visual overrides inherit the shared style when omitted.
    # text-size 18
    # text-colour "system"
    # background-colour "system"
    # border-colour "#d65d26"
    # borders true
    # radius 8
  end
end

`overlays`

Shared overlay palette and geometry, independent from window decorations.

Option	Type	Default	Notes
`background-colour`	auto \| system \| light \| dark \| hex	`auto`	Overlay background color. system follows the XDG desktop colour-scheme preference; auto remains deterministic.
`text-colour`	auto \| system \| light \| dark \| hex	`auto`	Overlay text color. system follows the XDG desktop colour-scheme preference; auto remains deterministic.
`error-colour`	auto \| system \| light \| dark \| hex	`#fb4934`	Error-state color. system follows the XDG desktop colour-scheme preference; auto remains deterministic.
`border-colour`	auto \| system \| light \| dark \| hex	`#d65d26`	Shared compositor-overlay border color. It no longer inherits decorations.border.
`radius`	i32	`8`	Overlay corner radius.
`borders`	bool	`true`	Draws overlay borders.
`border-size`	i32	`3`	Shared overlay border width in pixels, clamped from 0 through 64.
`notifications`	nested block	`see overlays.notifications`	Notification placement and duration.
`zoom-indicator`	nested block	`see overlays.zoom-indicator`	Live per-monitor camera scale shown during zoom activity.

`overlays.notifications`

Compositor notification policy.

Option	Type	Default	Notes
`position`	six-corner/center positions	`top-center`	Accepted positions: top-left, top-center, top-right, bottom-left, bottom-center, bottom-right.
`success-duration-ms`	u64	`4000`	Success notice duration; must be greater than zero.
`error-duration-ms`	u64	`9000`	Error notice duration; must be greater than zero.

`overlays.zoom-indicator`

Live camera scale with activity-aware hold and fade timing.

Option	Type	Default	Notes
`enabled`	bool	`true`	Shows the affected monitor's scale to two decimal places while zooming.
`position`	six-corner/center positions	`bottom-center`	Accepted positions: top-left, top-center, top-right, bottom-left, bottom-center, bottom-right.
`hold-duration-ms`	u64	`750`	Time the final scale remains fully visible after input and smooth camera motion stop; must be greater than zero.
`fade-duration-ms`	u64	`180`	Fade-out duration after the hold; must be greater than zero.
`background`	bool	`true`	When false, draws text only and removes the card, border, backdrop blur, and shadow.
`text-size`	u16	`inherit font.size`	Optional private text size, clamped from 6 to 96 pixels.
`text-colour`	auto \| system \| light \| dark \| hex	`inherit overlays.text-colour`	Optional text color override. The text-color alias is accepted.
`background-colour`	auto \| system \| light \| dark \| hex	`inherit overlays.background-colour`	Optional card color override. The background-color alias is accepted.
`border-colour`	auto \| system \| light \| dark \| hex	`inherit overlays.border-colour`	Optional zoom-card border override. The border-color alias is accepted.
`opacity`	f32	`1.0`	Multiplies the indicator's activity fade and is clamped from 0.0 to 1.0.
`borders`	bool	`inherit overlays.borders`	Optional card border override; it has no visible effect when background is false.
`radius`	i32	`inherit overlays.radius`	Optional card radius override, clamped from 0 to 256 pixels; it has no visible effect when background is false.