Config Reference

`Animations`

Master animation defaults and nested animation blocks.

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.

animations:
  enabled true

  smooth-resize:
    enabled true
    duration-ms 90
  end

  maximize:
    enabled true
    duration-ms 240
  end

  fullscreen:
    enabled true
    duration-ms 240
  end

  window-open:
    enabled true
    duration-ms 620
  end

  window-close:
    enabled true
    duration-ms 270
    style "shrink"
  end

  tile:
    enabled true
    duration-ms 240
  end

  stack:
    enabled true
    duration-ms 220
  end

  raise:
    enabled true
    duration-ms 140
    scale 1.025
    shadow-boost 0.18
  end
end

`animations`

Master animation toggle and nested animation blocks.

Option	Type	Default	Notes
`enabled`	bool	`true`	Master animation toggle.
`smooth-resize`	nested block	`see animations.smooth-resize`	Resize animation settings.
`maximize`	nested block	`see animations.maximize`	Maximize transition settings.
`fullscreen`	nested block	`see animations.fullscreen`	Fullscreen transition settings.
`window-open`	nested block	`see animations.window-open`	Window open animation settings.
`window-close`	nested block	`see animations.window-close`	Window close animation settings.
`tile`	nested block	`see animations.tile`	Tile animation settings.
`stack`	nested block	`see animations.stack`	Stack animation settings.
`raise`	nested block	`see animations.raise`	Click/selection raise pulse settings.

`smooth-resize`

Resize transition timing.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables animated resize transitions.
`duration-ms`	u64	`90`	Resize animation duration.

`maximize`

Visual-only maximize transition timing.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables visual maximize and unmaximize transitions.
`duration-ms`	u64	`240`	Maximize animation duration. The animation only tweens the presented rect; field geometry stays unchanged in v0.3.0.

`fullscreen`

Visual transition into compositor-managed fullscreen.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables visual fullscreen transitions.
`duration-ms`	u64	`240`	Fullscreen animation duration.

`window-open`

Window open transition settings.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables animated window open transitions.
`duration-ms`	u64	`620`	Open animation duration.

`window-close`

Window close transition timing and style.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables animated window close transitions.
`duration-ms`	u64	`270`	Close animation duration.
`style`	string	`shrink`	Close animation style. Accepted values: shrink, fade. fade is available in v0.3.0 and newer.

`tile`

Tile layout animation settings.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables tile layout animations.
`duration-ms`	u64	`240`	Tile animation duration.

`stack`

Stack layout animation settings.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables stack layout animations.
`duration-ms`	u64	`220`	Stack animation duration.

`raise`

Pulse animation used when a window is explicitly raised.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables the raise pulse animation.
`duration-ms`	u64	`140`	Raise pulse duration.
`scale`	f32	`1.025`	Peak scale multiplier for the raised window.
`shadow-boost`	f32	`0.18`	Temporary shadow boost during the raise pulse.