Config Reference

`Rules`

Window rule blocks and individual matching/placement policy options.

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.

rules:
  rule:
    app-id "firefox"
    title [r"File Upload.*", r"Open File.*"]
    opacity 0.96
    width 720
    height 520
    spawn-placement "center"
    cluster-participation "float"
  end
end

`rules`

Window-rule blocks.

Option	Type	Default	Notes
`rule`	nested block	`none`	Repeated window-rule block.

`rule`

Individual window matching and placement policy.

Option	Type	Default	Notes
`app-id`	quoted string, regex, or array	`required if title omitted`	Matches window app IDs. Arrays can mix literals and regex literals like r"Firefox.*".
`title`	quoted string, regex, or array	`required if app-id omitted`	Matches window titles.
`opacity`	f32	`1.0`	Matched opacity from 0.0 through 1.0. Translucent windows block direct scanout.
`width`	u32	`unset`	Optional fixed initial width for matching windows.
`height`	u32	`unset`	Optional fixed initial height for matching windows.
`overlap-policy`	string	`deprecated`	Deprecated no-op in v0.3.0. Expanded windows can overlap normally; use spawn-placement for initial position and cluster-participation "float" for floating dialogs.
`spawn-placement`	string	`placement.expanded.strategy`	Initial placement strategy for matching windows. Accepted values include center, viewport-center, cursor, app, and find-empty.
`cluster-participation`	string	`layout`	Controls whether matching windows join layout management or float. Accepted values: layout, float.