Skip to main content

​
Blur Effects

Mango supports sophisticated blur effects for windows and layer surfaces.

​
Basic Blur Settings

​
blur
boolean
default:"0"
Enable blur effect for windows
  • 1 - Enable blur
  • 0 - Disable blur
blur=0
​
blur_layer
boolean
default:"0"
Enable blur effect for layer surfaces (like panels, docks, and overlays)
blur_layer=0
​
blur_optimized
boolean
default:"1"
Use optimized blur algorithm for better performance
blur_optimized=1

​
Blur Parameters

Fine-tune blur appearance with these advanced parameters:
​
blur_params_num_passes
integer
default:"2"
Number of blur passes. More passes = smoother blur but lower performance
blur_params_num_passes=2
​
blur_params_radius
integer
default:"5"
Blur radius in pixels. Higher values = more blur
blur_params_radius=5
​
blur_params_noise
float
default:"0.02"
Amount of noise to add to blur (reduces banding)Range: 0.0 - 1.0
blur_params_noise=0.02
​
blur_params_brightness
float
default:"0.9"
Brightness adjustment for blurred contentRange: 0.0 - 2.0 (1.0 = no change)
blur_params_brightness=0.9
​
blur_params_contrast
float
default:"0.9"
Contrast adjustment for blurred contentRange: 0.0 - 2.0 (1.0 = no change)
blur_params_contrast=0.9
​
blur_params_saturation
float
default:"1.2"
Saturation adjustment for blurred contentRange: 0.0 - 2.0 (1.0 = no change)
blur_params_saturation=1.2

​
Blur Examples

​
Subtle Blur

blur=1
blur_optimized=1
blur_params_num_passes=2
blur_params_radius=3
blur_params_noise=0.01
blur_params_brightness=1.0
blur_params_contrast=1.0
blur_params_saturation=1.0

​
Strong Blur

blur=1
blur_optimized=1
blur_params_num_passes=4
blur_params_radius=10
blur_params_noise=0.03
blur_params_brightness=0.8
blur_params_contrast=0.8
blur_params_saturation=1.4

​
Shadows

Add drop shadows to windows for depth and visual separation.

​
Basic Shadow Settings

​
shadows
boolean
default:"0"
Enable shadows for windows
shadows=0
​
layer_shadows
boolean
default:"0"
Enable shadows for layer surfaces
layer_shadows=0
​
shadow_only_floating
boolean
default:"1"
Only show shadows on floating windows
  • 1 - Shadows only on floating windows
  • 0 - Shadows on all windows
shadow_only_floating=1

​
Shadow Appearance

​
shadows_size
integer
default:"10"
Shadow size in pixels
shadows_size=10
​
shadows_blur
integer
default:"15"
Shadow blur amount in pixels. Higher = softer shadows
shadows_blur=15
​
shadowscolor
color
default:"0x000000ff"
Shadow color in RGBA hexadecimal format
shadowscolor=0x000000ff

​
Shadow Position

​
shadows_position_x
integer
default:"0"
Horizontal shadow offset in pixels
  • Positive values: shadow to the right
  • Negative values: shadow to the left
shadows_position_x=0
​
shadows_position_y
integer
default:"0"
Vertical shadow offset in pixels
  • Positive values: shadow downward
  • Negative values: shadow upward
shadows_position_y=0

​
Shadow Examples

​
Soft Drop Shadow

shadows=1
layer_shadows=0
shadow_only_floating=1
shadows_size=15
shadows_blur=20
shadows_position_x=0
shadows_position_y=5
shadowscolor=0x00000088

​
Hard Shadow

shadows=1
shadow_only_floating=0
shadows_size=8
shadows_blur=5
shadows_position_x=3
shadows_position_y=3
shadowscolor=0x000000cc

​
Corner Radius

Round window corners for a modern appearance.
​
border_radius
integer
default:"6"
Corner radius in pixels
border_radius=6
​
no_radius_when_single
boolean
default:"0"
Disable rounded corners when only one window is visible
no_radius_when_single=0

​
Corner Radius Examples

# No rounded corners
border_radius=0

# Subtle rounding
border_radius=4

# Modern rounded
border_radius=10

# Heavily rounded
border_radius=20

​
Window Opacity

Control transparency of focused and unfocused windows.
​
focused_opacity
float
default:"1.0"
Opacity for the focused window (0.0 = transparent, 1.0 = opaque)
focused_opacity=1.0
​
unfocused_opacity
float
default:"1.0"
Opacity for unfocused windows (0.0 = transparent, 1.0 = opaque)
unfocused_opacity=1.0

​
Opacity Examples

# Dimmed unfocused windows
focused_opacity=1.0
unfocused_opacity=0.85

# Transparent terminal background
focused_opacity=0.95
unfocused_opacity=0.8

​
Complete Effects Configuration

Here’s a full example with all effects enabled: 
# Blur
blur=1
blur_layer=1
blur_optimized=1
blur_params_num_passes=2
blur_params_radius=5
blur_params_noise=0.02
blur_params_brightness=0.9
blur_params_contrast=0.9
blur_params_saturation=1.2

# Shadows
shadows=1
layer_shadows=1
shadow_only_floating=1
shadows_size=10
shadows_blur=15
shadows_position_x=0
shadows_position_y=0
shadowscolor=0x000000ff

# Rounded corners
border_radius=6
no_radius_when_single=0

# Opacity
focused_opacity=1.0
unfocused_opacity=1.0

​
Performance Considerations

Enabling multiple effects can impact performance, especially on lower-end hardware.
Performance Tips:
  1. Enable blur_optimized for better blur performance
  2. Reduce blur_params_num_passes if experiencing lag
  3. Lower blur_params_radius for faster rendering
  4. Use shadow_only_floating=1 to reduce shadow rendering overhead
  5. Disable layer_shadows if not needed

​
Minimal Configuration

For best performance with minimal effects: 
# Disable effects
blur=0
blur_layer=0
shadows=0
layer_shadows=0

# Keep subtle rounded corners
border_radius=4
no_radius_when_single=0

# Full opacity
focused_opacity=1.0
unfocused_opacity=1.0

Build docs developers (and LLMs) love

Get started for freeTalk to us