Config Reference

`Rules`

Strict first-match policy for managed windows and layer-shell surfaces.

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.

rules:
  window-rule:
    app-id "firefox"
    title r"Picture.*"
    opacity 0.96
    blur true
    spawn-placement "cursor"
    cluster-participation "float"
  end

  layer-rule:
    namespace "waybar"
    layer "top"
    blur true
  end
end

`rules`

Repeated rule blocks.

Option	Type	Default	Notes
`window-rule`	repeated nested block	`none`	Matches a managed Wayland or XWayland toplevel.
`layer-rule`	repeated nested block	`none`	Matches a layer-shell namespace and optional layer.

`rules.window-rule`

Window matching, initial geometry, visual policy, and cluster participation.

Option	Type	Default	Notes
`app-id`	string \| regex \| array	`optional`	Exact or regex application-id match.
`title`	string \| regex \| array	`optional`	Exact or regex title match.
`width \| height`	u32	`unset`	Optional fixed initial dimensions.
`opacity`	f32	`1.0`	Opacity from 0.0 through 1.0.
`blur`	bool	`unset`	Explicit client blur activation policy.
`spawn-placement`	center \| viewport-center \| cursor \| app \| find-empty	`center`	Initial window placement.
`cluster-participation`	layout \| float	`layout`	Whether the window joins cluster layout management.

`rules.layer-rule`

Layer-shell blur matching.

Option	Type	Default	Notes
`namespace`	string \| regex \| array	`required`	Layer-shell namespace match.
`layer`	string \| array	`any`	Optional background, bottom, top, or overlay layer match.
`blur`	bool	`required`	Enables or disables blur for the matching surface.