Config Reference

`View`

Repeated per-output hardware and focus-ring policy. The stable page URL is retained from older releases.

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.

view:
  output:
    name "DP-1"
    # width 2560
    # height 1440
    # rate 179.998
    # vrr "auto"

    focus-ring:
      radius-x 820.0
      radius-y 420.0
      offset-x 0.0
      offset-y 0.0
    end
  end
end

`view`

The single canonical container for repeated output blocks.

Option	Type	Default	Notes
`output`	repeated nested block	`none`	One entry per exact output connector. Duplicate names are rejected.

`view.output`

Hardware selection and output-local focus-ring policy.

Option	Type	Default	Notes
`name`	string	`required`	Exact connector printed by halleyctl outputs.
`width + height`	u32 pair	`unset`	Both are required together to select hardware mode policy.
`offset-x \| offset-y`	i32	`0`	Output origin; valid only with width and height.
`rate`	positive f32	`highest matching`	Must exactly match an advertised refresh rate.
`transform`	0 \| 90 \| 180 \| 270	`0`	Clockwise output rotation; valid only with width and height.
`vrr`	off \| on \| auto	`off`	Auto enables VRR for a settled fullscreen window when supported.
`focus-ring`	nested block	`builtin`	Camera-relative decay ellipse. A ring-only output entry is portable.

`view.output.focus-ring`

Per-output attention ellipse.

Option	Type	Default	Notes
`radius-x`	f32	`820.0`	Horizontal ellipse radius.
`radius-y`	f32	`420.0`	Vertical ellipse radius.
`offset-x`	f32	`0.0`	Camera-relative horizontal offset.
`offset-y`	f32	`0.0`	Camera-relative vertical offset.