Config Reference

`Effects`

Backdrop blur policy and renderer-level shadow settings.

Defaults

Defaults shown here are the effective builtin defaults from RuntimeTuning::builtin_defaults().

Default Config Shape

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

effects:
  blur:
    enabled false
    overlays true
    windows "auto"
    layer-shell "off"
    method "dual-kawase"
    radius 24
    passes 3
    saturation 1.10
    noise 0.012
  end

  shadows:
    window:
      enabled true
      blur-radius 8
      spread 0
      offset-x 0
      offset-y 5
      colour "#05030530"
    end

    node:
      enabled true
      blur-radius 14
      spread 0
      offset-x 0
      offset-y 3
      colour "#05030524"
    end

    overlay:
      enabled true
      blur-radius 24
      spread 1
      offset-x 0
      offset-y 7
      colour "#05030538"
    end
  end
end

`effects`

Renderer-level visual effects such as backdrop blur and compositor shadows.

Option	Type	Default	Notes
`blur`	nested block	`see effects.blur`	Backdrop blur policy for overlays, windows, and layer-shell surfaces.
`shadows`	nested block	`see effects.shadows`	Window, node, and overlay shadows. This replaces decorations.shadows.

`blur`

Global and per-surface-class backdrop blur policy.

Option	Type	Default	Notes
`enabled`	bool	`false`	Master switch. When false, no backdrop blur is computed anywhere.
`overlays`	bool	`true`	Allows compositor-owned overlays to use blur when they opt in.
`windows`	string	`auto`	Client window blur policy. Accepted values: off, auto, always. Rule-level blur true can opt a window in; rule-level blur false always wins.
`layer-shell`	string	`off`	Layer-shell blur policy for bars, launchers, notifications, and their popups. Accepted values: off, auto, always.
`method`	string	`dual-kawase`	Blur algorithm. dual-kawase is the shipped fast downsampled blur path.
`radius`	u32	`24`	Blur radius.
`passes`	u32	`3`	Number of blur passes.
`saturation`	f32	`1.10`	Backdrop saturation multiplier for frosted-glass surfaces.
`noise`	f32	`0.012`	Subtle noise amount for frosted-glass surfaces.

`shadows.window`

Shadow layer used by windows.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables window shadows.
`blur-radius`	f32	`8`	Shadow blur radius.
`spread`	f32	`0`	Shadow spread.
`offset-x`	f32	`0`	Horizontal shadow offset.
`offset-y`	f32	`5`	Vertical shadow offset.
`colour`	hex rgba	`#05030530`	Shadow color, including alpha.

`shadows.node`

Shadow layer used by collapsed nodes and cores.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables node shadows.
`blur-radius`	f32	`14`	Shadow blur radius.
`spread`	f32	`0`	Shadow spread.
`offset-x`	f32	`0`	Horizontal shadow offset.
`offset-y`	f32	`3`	Vertical shadow offset.
`colour`	hex rgba	`#05030524`	Shadow color, including alpha.

`shadows.overlay`

Shadow layer used by overlay containers.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables overlay shadows.
`blur-radius`	f32	`24`	Shadow blur radius.
`spread`	f32	`1`	Shadow spread.
`offset-x`	f32	`0`	Horizontal shadow offset.
`offset-y`	f32	`7`	Vertical shadow offset.
`colour`	hex rgba	`#05030538`	Shadow color, including alpha.