Skip to content
Noctalia Noctalia
FAQ

Keybinds

Take full control of Noctalia with keyboard shortcuts and IPC commands. This section covers all available commands you can bind to your favorite keys.

Available Commands

Section titled “Available Commands”

Every aspect of the shell can be controlled via IPC (Inter-Process Communication). Commands are grouped into the following categories:

Core & Navigation Launcher, Control Center, Settings and basic utilities.
System Controls Audio, Media, Connectivity, Display and Power management.
Interface & Plugins Notifications, Appearance, Security and Plugin controls.

Example Configurations

Section titled “Example Configurations”

Apply these binds in your window manager configuration to integrate Noctalia.

Niri Configuration

Both spawn-sh and spawn are usable to run Noctalia keybinds.

Add these binds to your ~/.config/niri/config.kdl:

binds {
    // Core Noctalia binds
    Mod+Space { spawn-sh "qs -c noctalia-shell ipc call launcher toggle"; }
    Mod+S { spawn-sh "qs -c noctalia-shell ipc call controlCenter toggle"; }
    Mod+Comma { spawn-sh "qs -c noctalia-shell ipc call settings toggle"; }


    // Audio & Brightness
    XF86AudioRaiseVolume { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "volume" "increase"; }
    XF86AudioLowerVolume { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "volume" "decrease"; }
    XF86AudioMute { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "volume" "muteOutput"; }
    XF86MonBrightnessUp { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "brightness" "increase"; }
    XF86MonBrightnessDown { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "brightness" "decrease"; }
}
Hyprland Configuration

Add these binds to your hyprland.conf:

$ipc = qs -c noctalia-shell ipc call


# Core binds
bind = SUPER, SPACE, exec, $ipc launcher toggle
bind = SUPER, S, exec, $ipc controlCenter toggle
bind = SUPER, comma, exec, $ipc settings toggle


# Media keys
bindel = , XF86AudioRaiseVolume, exec, $ipc volume increase
bindel = , XF86AudioLowerVolume, exec, $ipc volume decrease
bindl = , XF86AudioMute, exec, $ipc volume muteOutput
bindel = , XF86MonBrightnessUp, exec, $ipc brightness increase
bindel = , XF86MonBrightnessDown, exec, $ipc brightness decrease
Sway / Scroll Configuration

Add these binds to your ~/.config/sway/config (or equivalent for your compositor):

Terminal window
set $ipc qs -c noctalia-shell ipc call


# Core binds
bindsym $mod+space exec $ipc launcher toggle
bindsym $mod+s exec $ipc controlCenter toggle
bindsym $mod+comma exec $ipc settings toggle


# Media keys
bindsym --locked XF86AudioRaiseVolume exec $ipc volume increase
bindsym --locked XF86AudioLowerVolume exec $ipc volume decrease
bindsym --locked XF86AudioMute exec $ipc volume muteOutput
bindsym --locked XF86MonBrightnessUp exec $ipc brightness increase
bindsym --locked XF86MonBrightnessDown exec $ipc brightness decrease
MangoWC Configuration

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

Terminal window
# Core binds
bind=SUPER,space,spawn,qs -c noctalia-shell ipc call launcher toggle
bind=SUPER,s,spawn,qs -c noctalia-shell ipc call controlCenter toggle
bind=SUPER,comma,spawn,qs -c noctalia-shell ipc call settings toggle


# Media keys
bind=NONE,XF86AudioRaiseVolume,spawn,qs -c noctalia-shell ipc call volume increase
bind=NONE,XF86AudioLowerVolume,spawn,qs -c noctalia-shell ipc call volume decrease
bind=NONE,XF86AudioMute,spawn,qs -c noctalia-shell ipc call volume muteOutput
bind=NONE,XF86MonBrightnessUp,spawn,qs -c noctalia-shell ipc call brightness increase
bind=NONE,XF86MonBrightnessDown,spawn,qs -c noctalia-shell ipc call brightness decrease

Discovering Commands

Section titled “Discovering Commands”

Not sure what else you can control? You can see all IPC commands via this terminal command:

List all targets:

Terminal window
qs -c noctalia-shell ipc show