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

  cluster:
    enabled true

    tiling:
      open-duration-ms 300
      stagger-ms 55
      close-duration-ms 420
    end

    stacking:
      open-duration-ms 240
      close-duration-ms 360
    end
  end

  raise:
    enabled true
    duration-ms 140
    trigger "overlap"
    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.
`cluster`	nested block	`see animations.cluster`	Cluster workspace open and close animations for tiling and stacking layouts.
`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.

`cluster`

Cluster workspace open and close animations for tiling and stacking layouts.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables cluster workspace open and close animations.
`tiling`	nested block	`see animations.cluster.tiling`	Tiling layout open cascade and close suck-into-core timing.
`stacking`	nested block	`see animations.cluster.stacking`	Stacking layout card grow-in and close suck-into-core timing.

`cluster.tiling`

Tiling cluster workspace open cascade, per-member stagger, and close timing.

Option	Type	Default	Notes
`open-duration-ms`	u64	`300`	Open animation duration. Members cascade in from the left.
`stagger-ms`	u64	`55`	Per-member open delay, slaves first and master last. 0 opens members together.
`close-duration-ms`	u64	`420`	Close animation duration. Members shrink and fade into the core node.

`cluster.stacking`

Stacking cluster workspace card grow-in and close timing.

Option	Type	Default	Notes
`open-duration-ms`	u64	`240`	Open card grow-in animation duration.
`close-duration-ms`	u64	`360`	Close animation duration. Cards shrink and fade into the core node.

`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.
`trigger`	string	`overlap`	Controls when raise animation triggers. Accepted values: overlap, always.
`scale`	f32	`1.025`	Peak scale multiplier for the raised window.
`shadow-boost`	f32	`0.18`	Temporary shadow boost during the raise pulse.