Mango

Configure Mango for Noctalia surfaces and use Mango binds to launch Noctalia IPC commands directly from the compositor.

Autostart Noctalia

Add to your ~/.config/mango/config.conf:

Terminal window

exec-once=noctalia

Blur and shadows

Section titled “Blur and shadows”

Mango’s SceneFX layer blur does not filter by surface opacity. If layer blur is enabled, transparent Noctalia surfaces can still receive compositor blur. For the cleanest result, disable Mango’s blur and layer shadows, and turn on Noctalia’s own drop shadows.

Add this to ~/.config/mango/config.conf:

blur=1blur_layer=0blur_optimized=1blur_params_num_passes=2blur_params_radius=5blur_params_noise=0.02blur_params_brightness=0.9blur_params_contrast=0.9blur_params_saturation=1.0layer_animations=0
shadows=1layer_shadows=0shadow_only_floating=0shadows_size=4shadows_blur=12shadows_position_x=2shadows_position_y=2shadowscolor=0x000000ff

Mango uses blur_layer for layer-surface blur and layer_shadows for layer-surface shadows. Use those exact names; both also require their global toggles, blur=1 and shadows=1.

Then disable Noctalia’s rendered drop shadows in your Noctalia TOML config:

[bar.main]shadow = falsecontact_shadow = false
[dock]shadow = false
[shell.panel]shadow = false

If you have more than one bar, set shadow = false on each [bar.<name>] entry.

IPC Keybinds

Section titled “IPC Keybinds”

Add these binds to your ~/.config/mango/config.conf:

Terminal window

# Core bindsbind=SUPER,space,spawn,noctalia msg panel-toggle launcherbind=SUPER,s,spawn,noctalia msg panel-toggle control-centerbind=SUPER,comma,spawn,noctalia msg settings-toggle
# Media keysbind=NONE,XF86AudioRaiseVolume,spawn,noctalia msg volume-upbind=NONE,XF86AudioLowerVolume,spawn,noctalia msg volume-downbind=NONE,XF86AudioMute,spawn,noctalia msg volume-mutebind=NONE,XF86MonBrightnessUp,spawn,noctalia msg brightness-upbind=NONE,XF86MonBrightnessDown,spawn,noctalia msg brightness-down