Mango provides extensive animation options to customize window and tag transition effects.
General Animation Settings
| Option | Type | Default | Description |
|---|
animations | integer | 1 | Enable window animations (0=disabled, 1=enabled) |
layer_animations | integer | 1 | Enable animations for layer surfaces (0=disabled, 1=enabled) |
Animation Types
Window Open Animation
| Option | Type | Default | Description |
|---|
animation_type_open | string | slide | Animation type when opening windows |
animation_fade_in | integer | 1 | Enable fade-in during open animation |
fadein_begin_opacity | float | 0.5 | Starting opacity for fade-in (0.0-1.0) |
zoom, slide
Window Close Animation
| Option | Type | Default | Description |
|---|
animation_type_close | string | slide | Animation type when closing windows |
animation_fade_out | integer | 1 | Enable fade-out during close animation |
fadeout_begin_opacity | float | 0.8 | Starting opacity for fade-out (0.0-1.0) |
zoom, slide
Zoom Animation Parameters
| Option | Type | Default | Description |
|---|
zoom_initial_ratio | float | 0.3 | Initial scale ratio for zoom animation (0.0-1.0) |
zoom_end_ratio | float | 0.8 | End scale ratio for zoom animation (0.0-1.0) |
Tag Animation
| Option | Type | Default | Description |
|---|
tag_animation_direction | integer | 1 | Tag switch animation direction (1=horizontal, 0=vertical) |
Animation Duration
All duration values are in milliseconds.
| Option | Type | Default | Description |
|---|
animation_duration_open | integer | 400 | Duration for window open animation (ms) |
animation_duration_close | integer | 800 | Duration for window close animation (ms) |
animation_duration_move | integer | 500 | Duration for window move animation (ms) |
animation_duration_tag | integer | 350 | Duration for tag switch animation (ms) |
animation_duration_focus | integer | 0 | Duration for focus change animation (ms) |
Setting duration to 0 disables that specific animation transition.
Animation Curves
Animation curves use cubic-bezier format with four values: x1,y1,x2,y2
These control points define the timing function for animations, similar to CSS cubic-bezier.
| Option | Type | Default | Description |
|---|
animation_curve_open | bezier | 0.46,1.0,0.29,1 | Timing curve for open animation |
animation_curve_close | bezier | 0.08,0.92,0,1 | Timing curve for close animation |
animation_curve_move | bezier | 0.46,1.0,0.29,1 | Timing curve for move animation |
animation_curve_tag | bezier | 0.46,1.0,0.29,1 | Timing curve for tag switch |
animation_curve_focus | bezier | 0.46,1.0,0.29,1 | Timing curve for focus change |
animation_curve_opafadein | bezier | 0.46,1.0,0.29,1 | Timing curve for fade-in opacity |
animation_curve_opafadeout | bezier | 0.5,0.5,0.5,0.5 | Timing curve for fade-out opacity |
Understanding Cubic-Bezier Curves
Cubic-bezier curves are defined by four values: x1, y1, x2, y2
x1, y1 - First control point (x1 and y1 should be between 0 and 1)x2, y2 - Second control point (x2 and y2 should be between 0 and 1)- Start point is always
(0, 0) and end point is always (1, 1)
Common Curve Presets
| Preset | Values | Effect |
|---|
| Linear | 0.0,0.0,1.0,1.0 | Constant speed |
| Ease | 0.25,0.1,0.25,1.0 | Slow start, fast middle, slow end |
| Ease-in | 0.42,0.0,1.0,1.0 | Slow start, fast end |
| Ease-out | 0.0,0.0,0.58,1.0 | Fast start, slow end |
| Ease-in-out | 0.42,0.0,0.58,1.0 | Slow start and end |
Per-Layer Animation Override
You can override animation types for specific layer surfaces using layer rules:
layerrule=animation_type_open:zoom,layer_name:rofi
layerrule=animation_type_close:zoom,layer_name:rofi
Examples
Smooth and Slow Animations
animations=1
animation_type_open=slide
animation_type_close=slide
animation_duration_open=600
animation_duration_close=600
animation_curve_open=0.25,0.1,0.25,1.0
animation_curve_close=0.25,0.1,0.25,1.0
Fast and Snappy Animations
animations=1
animation_type_open=zoom
animation_type_close=zoom
animation_duration_open=200
animation_duration_close=200
zoom_initial_ratio=0.8
animation_curve_open=0.0,0.0,0.58,1.0
animation_curve_close=0.42,0.0,1.0,1.0
Disable All Animations
animations=0
layer_animations=0
Fade-Only Animations
animations=1
animation_type_open=slide
animation_type_close=slide
animation_fade_in=1
animation_fade_out=1
fadein_begin_opacity=0.0
fadeout_begin_opacity=1.0
animation_duration_open=300
animation_duration_close=300
- Longer animation durations (>500ms) may feel sluggish on slower hardware
- Zoom animations can be more GPU-intensive than slide animations
- Disabling
layer_animations can improve performance on systems with many overlay surfaces
- Setting
animation_duration_focus=0 prevents focus animations, which can feel more responsive
See Also
