Take full control of Noctalia with keyboard shortcuts and IPC commands. This section covers all available commands you can bind to your favorite keys.
Installation-specific commands
- NixOS Flake users: Use
noctalia-shelldirectly instead ofqs -c noctalia-shell- PikaOS: Use
qsinstead ofqs -c noctalia-shell- Manual installation users: If you have Noctalia in
~/.config/quickshell/, you can useqs ipc call...directly
Available Commands
Every aspect of the shell can be controlled via IPC (Inter-Process Communication). Commands are grouped into the following categories:
Note In the subpages below, commands are shown in their shortened form (e.g.,
launcher toggle). Hover over any command to see the fullipc callsyntax, or use the copy icon to copy the full command to your clipboard.
-
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
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`: ```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`: ```ini $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): ```bash 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 ```Mango Configuration
Add these binds to your `~/.config/mango/config.conf`: ```bash # 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
Not sure what else you can control? You can see all IPC commands via this terminal command:
List all targets: bash qs -c noctalia-shell ipc show