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:

exec-once=noctalia

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, let Mango own both layer blur and layer shadows, and turn off Noctalia’s own drop shadows so the effects do not stack.

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

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.0

shadows=1
layer_shadows=1
shadow_only_floating=1
shadows_size=12
shadows_blur=15
shadows_position_x=0
shadows_position_y=0
shadowscolor=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 = false
contact_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

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

# Core binds
bind=SUPER,space,spawn,noctalia msg panel-toggle launcher
bind=SUPER,s,spawn,noctalia msg panel-toggle control-center
bind=SUPER,comma,spawn,noctalia msg settings-toggle

# Media keys
bind=NONE,XF86AudioRaiseVolume,spawn,noctalia msg volume-up
bind=NONE,XF86AudioLowerVolume,spawn,noctalia msg volume-down
bind=NONE,XF86AudioMute,spawn,noctalia msg volume-mute
bind=NONE,XF86MonBrightnessUp,spawn,noctalia msg brightness-up
bind=NONE,XF86MonBrightnessDown,spawn,noctalia msg brightness-down