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.*"]
    overlap-policy "all"
    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.
`overlap-policy`	string	`none`	Controls overlap allowed during initial placement. Accepted values: none, parent-only, all.
`spawn-placement`	string	`adjacent`	Initial placement strategy for matching windows. Accepted values: adjacent, center, viewport-center, cursor, app.
`cluster-participation`	string	`layout`	Controls whether matching windows join layout management or float. Accepted values: layout, float.