Config Reference

`Gamescope`

Gamescope launch defaults and per-game profile overrides.

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.

gamescope:
  enabled true
  monitor "focused"
  output-width "auto"
  output-height "auto"
  game-width "auto"
  game-height "auto"
  refresh "auto"
  fullscreen true
  borderless false
  suppress-overlays true
  passthrough-pointer-lock true
  bypass-spatial-camera true

  game:
    name "Example Game"
    app-id "steam_app_123456"
    enabled true
  end
end

`gamescope`

Defaults for launching selected games through gamescope from halleyctl.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables gamescope wrapping for matching launches.
`monitor`	string	`focused`	Monitor selector used for automatic dimensions. Accepted values: focused, cursor, primary, or a connector name.
`output-width`	u32 or auto	`auto`	Gamescope output width. auto resolves from the selected monitor when possible.
`output-height`	u32 or auto	`auto`	Gamescope output height. auto resolves from the selected monitor when possible.
`game-width`	u32 or auto	`auto`	Internal game width passed to gamescope.
`game-height`	u32 or auto	`auto`	Internal game height passed to gamescope.
`refresh`	u32 or auto	`auto`	Refresh rate passed to gamescope when known.
`fullscreen`	bool	`true`	Launches gamescope fullscreen. Fullscreen wins if both fullscreen and borderless are true.
`borderless`	bool	`false`	Launches gamescope borderless when fullscreen is false.
`suppress-overlays`	bool	`true`	Suppresses Halley overlay reveals while a managed game holds pointer lock or confinement.
`passthrough-pointer-lock`	bool	`true`	Preserves game pointer lock behavior for wrapped launches.
`bypass-spatial-camera`	bool	`true`	Routes pointer input to gamescope-managed surfaces without spatial-camera remapping.
`game`	nested block	`none`	Repeated per-game profile block. Profiles match by app-id and inherit global defaults.

`game`

Per-game Gamescope overrides matched by app id.

Option	Type	Default	Notes
`name`	string	`optional`	Human-readable profile name.
`app-id`	string	`required`	Steam or app id matched by halleyctl gamescope run.
`enabled`	bool	`inherited`	Set false to opt a matching game out of wrapping.
`monitor`	string	`inherited`	Profile-specific monitor selector.
`output-width`	u32 or auto	`inherited`	Profile-specific gamescope output width.
`output-height`	u32 or auto	`inherited`	Profile-specific gamescope output height.
`game-width`	u32 or auto	`inherited`	Profile-specific internal game width.
`game-height`	u32 or auto	`inherited`	Profile-specific internal game height.
`refresh`	u32 or auto	`inherited`	Profile-specific refresh rate.
`fullscreen`	bool	`inherited`	Profile-specific fullscreen flag.
`borderless`	bool	`inherited`	Profile-specific borderless flag.