Skip to main content

​
Animation Types

Mango supports two primary animation types:
  • slide - Windows slide in/out from edges
  • zoom - Windows scale up/down

​
Basic Animation Settings

​
animations
boolean
default:"1"
Enable animations for windows
animations=1
​
layer_animations
boolean
default:"1"
Enable animations for layer surfaces (panels, overlays, etc.)
layer_animations=1

​
Animation Types per Action

​
animation_type_open
enum
default:"slide"
Animation type when opening windowsValues: slide, zoom
animation_type_open=slide
​
animation_type_close
enum
default:"slide"
Animation type when closing windowsValues: slide, zoom
animation_type_close=slide

​
Fade Effects

​
animation_fade_in
boolean
default:"1"
Enable fade-in animation
animation_fade_in=1
​
animation_fade_out
boolean
default:"1"
Enable fade-out animation
animation_fade_out=1
​
fadein_begin_opacity
float
default:"0.5"
Starting opacity for fade-in (0.0 - 1.0)
fadein_begin_opacity=0.5
​
fadeout_begin_opacity
float
default:"0.8"
Starting opacity for fade-out (0.0 - 1.0)
fadeout_begin_opacity=0.8

​
Tag Animation

​
tag_animation_direction
integer
default:"1"
Direction for tag switching animations
  • 1 - Horizontal (left/right)
  • 0 - Vertical (up/down)
tag_animation_direction=1

​
Zoom Animation Parameters

​
zoom_initial_ratio
float
default:"0.3"
Initial scale ratio for zoom animations (0.0 - 1.0)
zoom_initial_ratio=0.3
​
zoom_end_ratio
float
default:"0.8"
End scale ratio for zoom animations (0.0 - 1.0)
zoom_end_ratio=0.8

​
Animation Durations

All durations are in milliseconds.
​
animation_duration_open
integer
default:"400"
Duration for window open animations in milliseconds
animation_duration_open=400
​
animation_duration_close
integer
default:"800"
Duration for window close animations in milliseconds
animation_duration_close=800
​
animation_duration_move
integer
default:"500"
Duration for window move animations in milliseconds
animation_duration_move=500
​
animation_duration_tag
integer
default:"350"
Duration for tag switching animations in milliseconds
animation_duration_tag=350
​
animation_duration_focus
integer
default:"0"
Duration for focus change animations in millisecondsSet to 0 to disable focus animations
animation_duration_focus=0

​
Animation Curves (Bezier Easing)

Animation curves use cubic Bezier format: x1,y1,x2,y2 Common easing curves:
  • Linear: 0,0,1,1
  • Ease-in-out: 0.42,0,0.58,1
  • Ease-out: 0,0,0.58,1
  • Ease-in: 0.42,0,1,1
  • Custom (Mango default): 0.46,1.0,0.29,1
​
animation_curve_open
string
default:"0.46,1.0,0.29,1"
Bezier curve for window open animations
animation_curve_open=0.46,1.0,0.29,1
​
animation_curve_close
string
default:"0.08,0.92,0,1"
Bezier curve for window close animations
animation_curve_close=0.08,0.92,0,1
​
animation_curve_move
string
default:"0.46,1.0,0.29,1"
Bezier curve for window move animations
animation_curve_move=0.46,1.0,0.29,1
​
animation_curve_tag
string
default:"0.46,1.0,0.29,1"
Bezier curve for tag switching animations
animation_curve_tag=0.46,1.0,0.29,1
​
animation_curve_focus
string
default:"0.46,1.0,0.29,1"
Bezier curve for focus change animations
animation_curve_focus=0.46,1.0,0.29,1
​
animation_curve_opafadeout
string
default:"0.5,0.5,0.5,0.5"
Bezier curve for opacity fade-out
animation_curve_opafadeout=0.5,0.5,0.5,0.5
​
animation_curve_opafadein
string
default:"0.46,1.0,0.29,1"
Bezier curve for opacity fade-in
animation_curve_opafadein=0.46,1.0,0.29,1

​
Complete Animation Configuration

​
Default Configuration

# Enable animations
animations=1
layer_animations=1

# Animation types
animation_type_open=slide
animation_type_close=slide

# Fade effects
animation_fade_in=1
animation_fade_out=1
fadein_begin_opacity=0.5
fadeout_begin_opacity=0.8

# Tag animation
tag_animation_direction=1

# Zoom parameters
zoom_initial_ratio=0.3
zoom_end_ratio=0.8

# Durations (milliseconds)
animation_duration_open=400
animation_duration_close=800
animation_duration_move=500
animation_duration_tag=350
animation_duration_focus=0

# Bezier curves
animation_curve_open=0.46,1.0,0.29,1
animation_curve_close=0.08,0.92,0,1
animation_curve_move=0.46,1.0,0.29,1
animation_curve_tag=0.46,1.0,0.29,1
animation_curve_focus=0.46,1.0,0.29,1
animation_curve_opafadeout=0.5,0.5,0.5,0.5
animation_curve_opafadein=0.46,1.0,0.29,1

​
Example Configurations

​
Fast and Snappy

animations=1
animation_type_open=zoom
animation_type_close=zoom
animation_duration_open=200
animation_duration_close=200
animation_duration_move=200
animation_duration_tag=200
animation_curve_open=0,0,0.58,1
animation_curve_close=0,0,0.58,1

​
Smooth and Slow

animations=1
animation_type_open=slide
animation_type_close=slide
animation_duration_open=600
animation_duration_close=1000
animation_duration_move=700
animation_duration_tag=500
animation_curve_open=0.42,0,0.58,1
animation_curve_close=0.42,0,0.58,1

​
Zoom with Fade

animations=1
animation_type_open=zoom
animation_type_close=zoom
animation_fade_in=1
animation_fade_out=1
zoom_initial_ratio=0.5
zoom_end_ratio=0.95
fadein_begin_opacity=0.0
fadeout_begin_opacity=1.0
animation_duration_open=350
animation_duration_close=350

​
No Animations (Performance)

animations=0
layer_animations=0
animation_duration_focus=0

​
Per-Layer Animation Overrides

You can override animation types for specific layer surfaces using layer rules: 
# Use zoom animation for rofi
layerrule=animation_type_open:zoom,layer_name:rofi
layerrule=animation_type_close:zoom,layer_name:rofi
See Rules for more information on layer rules.

​
Bezier Curve Reference

Visualize and create custom Bezier curves at:

​
Common Presets

# Linear
0,0,1,1

# Ease (default CSS)
0.25,0.1,0.25,1

# Ease-in
0.42,0,1,1

# Ease-out
0,0,0.58,1

# Ease-in-out
0.42,0,0.58,1

# Ease-in-back
0.6,-0.28,0.735,0.045

# Ease-out-back
0.175,0.885,0.32,1.275

# Ease-in-out-back
0.68,-0.55,0.265,1.55

​
Performance Tips

  1. Disable animations entirely on low-end hardware
  2. Reduce durations for snappier feel and better performance
  3. Disable layer animations if experiencing lag with overlays
  4. Set animation_duration_focus=0 to eliminate focus delay
  5. Use slide instead of zoom for slightly better performance

Build docs developers (and LLMs) love

Get started for freeTalk to us