Skip to content

effects

github-actions[bot] edited this page Oct 5, 2026 · 5 revisions

Blur

Blur creates a frosted glass effect for transparent windows.

Setting Default Description
blur 0 Enable blur for windows.
blur_layer 0 Enable blur for layer surfaces (like bars/docks).
blur_optimized 1 Caches the wallpaper and blur background, significantly reducing GPU usage. Disabling it will significantly increase GPU consumption and may cause rendering lag. Highly recommended.
blur_params_radius 5 The strength (radius) of the blur.
blur_params_num_passes 1 Number of passes. Higher = smoother but more expensive.
blur_params_noise 0.02 Blur noise level.
blur_params_brightness 0.9 Blur brightness adjustment.
blur_params_contrast 0.9 Blur contrast adjustment.
blur_params_saturation 1.2 Blur saturation adjustment.

Warning: Blur has a relatively high impact on performance. If your hardware is limited, it is not recommended to enable it. If you experience lag with blur on, ensure blur_optimized=1 — disabling it will significantly increase GPU consumption and may cause rendering lag. To disable blur entirely, set blur=0.


Shadows

Drop shadows help distinguish floating windows from the background.

Setting Default Description
shadows 0 Enable shadows.
layer_shadows 0 Enable shadows for layer surfaces.
shadow_only_floating 1 Only draw shadows for floating windows (saves performance).
shadows_size 10 Size of the shadow.
shadows_blur 15 Shadow blur amount.
shadows_position_x 0 Shadow X offset.
shadows_position_y 0 Shadow Y offset.
shadows_color 0x000000ff Color of the shadow.
# Example shadows configuration
shadows=1
layer_shadows=1
shadow_only_floating=1
shadows_size=12
shadows_blur=15
shadows_position_x=0
shadows_position_y=0
shadows_color=0x000000ff

Opacity & Corner Radius

Control the transparency and roundness of your windows.

Setting Default Description
border_radius 0 Window corner radius in pixels.
border_radius_location_default 0 Corner radius location: 0 (all), 1 (top-left), 2 (top-right), 3 (bottom-left), 4 (bottom-right), 5 (closest corner).
no_radius_when_single 0 Disable radius if only one window is visible.
focused_opacity 1.0 Opacity for the active window (0.0 - 1.0).
unfocused_opacity 1.0 Opacity for inactive windows (0.0 - 1.0).
# Window corner radius in pixels
border_radius=0

# Corner radius location (0=all, 1=top-left, 2=top-right, 3=bottom-left, 4=bottom-right)
border_radius_location_default=0

# Disable radius if only one window is visible
no_radius_when_single=0

# Opacity for the active window (0.0 - 1.0)
focused_opacity=1.0

# Opacity for inactive windows
unfocused_opacity=1.0

Dim Overlay

Draws a translucent layer over the content of a window, so it can be shaded without changing the opacity of the application itself. The layer never takes pointer input: clicks and drags always go to the window below it. Its corners follow border_radius, and it is resized together with the window, including while windows are being animated.

Colors use the usual 0xRRGGBBAA format, so the last two digits set the transparency of the overlay.

Setting Default Description
dim_enable 0 Enable the dim overlay on windows.
dim_focused_color 0x00000000 Dim color of the focused window.
dim_unfocused_color 0x00000055 Dim color of the unfocused windows.

With just dim_enable=1 the focused window stays untouched and the unfocused windows are shaded with 0x55 (about a third) black.

dim_enable=1
dim_focused_color=0x00000000
dim_unfocused_color=0x0000004d

Clone this wiki locally