Config Reference

`Viewport`

Monitor viewport settings, output connector blocks, and focus-ring defaults.

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.

viewport:
  DP-1:
    enabled true
    offset-x 0
    offset-y 0
    width 2560
    height 1440
    rate 180.0
    transform 0
    vrr "on"

    focus-ring:
      primary-rx 820.0
      primary-ry 420.0
      offset-x 0
      offset-y 0
    end
  end
end

`viewport`

Global fallback viewport defaults and per-output blocks.

Option	Type	Default	Notes
`center-x`	f32	`derived`	Fallback global viewport center x. Derived from the first enabled output when outputs are configured; otherwise 0.0.
`center-y`	f32	`derived`	Fallback global viewport center y. Derived from the first enabled output when outputs are configured; otherwise 0.0.
`size-w`	f32	`derived`	Fallback global viewport width. Derived from the first enabled output when outputs are configured; otherwise 1920.0.
`size-h`	f32	`derived`	Fallback global viewport height. Derived from the first enabled output when outputs are configured; otherwise 1080.0.
`<connector>`	nested block	`none`	Per-output block such as DP-1: or HDMI-A-1:.

`<connector>`

Per-output settings for a configured monitor connector.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables or disables the output.
`offset-x`	i32	`0`	Output origin x in the global monitor layout.
`offset-y`	i32	`0`	Output origin y in the global monitor layout.
`width`	u32	`required`	Output width in pixels.
`height`	u32	`required`	Output height in pixels.
`rate`	positive f32	`unset`	Refresh rate in Hz. When omitted, Halley uses the output default.
`transform`	u32	`0`	Output rotation. Accepted values: 0, 90, 180, 270.
`vrr`	string	`off`	Variable refresh rate mode. Accepted values: off, on, on-demand.
`focus-ring`	nested block	`inherited`	Optional per-output focus ring override.

`<connector>.focus-ring`

Per-output focus-ring override values.

Option	Type	Default	Notes
`primary-rx`	f32	`820.0`	Horizontal focus-ring radius for this output.
`primary-ry`	f32	`420.0`	Vertical focus-ring radius for this output.
`offset-x`	f32	`0.0`	Focus-ring x offset on this output.
`offset-y`	f32	`0.0`	Focus-ring y offset on this output.

`focus-ring`

Global focus-ring radius and offset defaults.

Option	Type	Default	Notes
`primary-rx`	f32	`820.0`	Global focus-ring horizontal radius. Aliases like rx and radius-x are also accepted.
`primary-ry`	f32	`420.0`	Global focus-ring vertical radius. Aliases like ry and radius-y are also accepted.
`offset-x`	f32	`0.0`	Global focus-ring x offset.
`offset-y`	f32	`0.0`	Global focus-ring y offset.