Config Reference

`Animations`

Window, fullscreen, maximize, resize, reversible arrangement, node, and cluster motion.

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.

animations:
  enabled true
  window-move:
    enabled true
    motion "easing"
    duration-ms 250
    curve "ease-out-cubic"
  end
  smooth-resize:
    enabled true
    duration-ms 90
  end
  window-open:
    enabled true
    type "center-out"
    duration-ms 300
    curve "linear"
  end
  window-close:
    enabled true
    type "shrink"
    duration-ms 270
  end
  fullscreen:
    enabled true
    motion "spring"
    damping-ratio 1.0
    stiffness 800.0
  end
  maximize:
    enabled true
    motion "easing"
    duration-ms 240
    curve "ease-in-out-cubic"
  end
  arrange:
    enabled true
    motion "easing"
    duration-ms 360
    curve "ease-in-out-cubic"
  end
  node:
    enabled true
    duration-ms 280 # Node marker appearance.
    collapse-duration-ms 280 # Window snapshot shrinking/traveling into the node.
  end
  cluster:
    enabled true
    tiling:
      open-duration-ms 300
      close-duration-ms 420
      reflow-duration-ms 240
      stagger-ms 55
    end
    stacking:
      open-duration-ms 240
      close-duration-ms 360
      cycle-duration-ms 220
    end
  end
end

`animations`

Master and nested animation groups.

Option	Type	Default	Notes
`enabled`	bool	`true`	Master animation switch.
`smooth-resize \| window-open \| window-close \| fullscreen \| maximize \| node \| cluster`	nested blocks	`builtin`	Independent motion groups.

`animations.smooth-resize`

Pointer-driven low-pass resize.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables smoothed interactive resize.
`duration-ms`	u64	`90`	Filter duration; release stops at the presented size.

`animations.window-open`

Newly mapped window motion.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables window-open animation.
`type`	center-out \| fade \| launch	`center-out`	Open visual style.
`duration-ms`	u64	`300`	Easing duration.
`curve`	easing name	`linear`	linear, ease-out-quad/cubic/expo, or elastic; spring motion uses damping and stiffness.
`custom-shader`	path string	`unset`	Optional GLSL fragment shader. The configured animation type owns geometry, and missing or invalid shaders fall back to it. Open/close shader examples are included in the Halley repository.

`animations.window-close`

Ordinary window close motion.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables close animation.
`type`	shrink \| fade \| retract	`shrink`	Close visual style.
`duration-ms`	u64	`270`	Close duration.
`custom-shader`	path string	`unset`	Optional GLSL fragment shader. The configured animation type owns geometry, and missing or invalid shaders fall back to it. Open/close shader examples are included in the Halley repository.

`animations.fullscreen`

Fullscreen enter and exit motion.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables fullscreen transitions.
`motion`	spring \| easing	`spring`	Motion model.
`damping-ratio`	f32	`1.0`	Spring damping.
`stiffness`	f32	`800.0`	Spring strength.
`duration-ms \| curve`	easing fields	`250 \| ease-out-cubic`	Used when motion is easing.

`animations.maximize`

Maximize and restore motion.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables maximize transitions.
`motion`	spring \| easing	`easing`	Motion model.
`duration-ms`	u64	`240`	Default easing duration.
`curve`	easing name	`ease-in-out-cubic`	Default easing curve.
`damping-ratio \| stiffness`	spring fields	`1.0 \| 800.0`	Used when motion is spring.

`animations.node`

Window/node transitions.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables node transition motion.
`duration-ms`	u64	`280`	Transition duration.
`collapse-duration-ms`	u64	`280`	Duration for the window snapshot shrinking and traveling into its collapsed node, separate from node appearance and window-close animation.

`animations.cluster`

Cluster workspace motion.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables cluster workspace motion.
`tiling`	nested block	`builtin`	Open, close, reflow, and stagger timings.
`stacking`	nested block	`builtin`	Open, close, and cycle timings.

`animations.cluster.tiling`

Tiling cluster timings.

Option	Type	Default	Notes
`open-duration-ms`	u64	`300`	Workspace open duration.
`close-duration-ms`	u64	`420`	Workspace close duration.
`reflow-duration-ms`	u64	`240`	Tile reflow duration.
`stagger-ms`	u64	`55`	Delay between member starts.

`animations.cluster.stacking`

Stacking cluster timings.

Option	Type	Default	Notes
`open-duration-ms`	u64	`240`	Workspace open duration.
`close-duration-ms`	u64	`360`	Workspace close duration.
`cycle-duration-ms`	u64	`220`	Card cycle duration.

`animations.arrange`

Motion for the reversible visible-Field mosaic.

Option	Type	Default	Notes
`enabled`	bool	`true`	Animate arrangement and restoration.
`motion`	spring \| easing	`easing`	Motion model.
`duration-ms`	u64	`360`	Duration in easing mode.
`curve`	easing name	`ease-in-out-cubic`	Curve in easing mode.
`damping-ratio \| stiffness`	spring fields	`1.0 \| 800.0`	Used when motion is spring.

`animations.window-move`

Independent keyboard and CLI movement; pointer drags remain direct.

Option	Type	Default	Notes
`enabled`	bool	`true`	Animate keyboard and CLI movement.
`motion`	easing \| spring	`easing`	Movement model.
`duration-ms`	u64	`250`	Easing duration.
`curve`	easing name	`ease-out-cubic`	Easing curve.
`damping-ratio \| stiffness`	spring fields	`1.0 \| 800.0`	Used in spring mode.