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.

Installation-specific commands

• NixOS Flake users: Use noctalia-shell directly instead of qs -c noctalia-shell
• PikaOS: Use qs instead of qs -c noctalia-shell
• Manual installation users: If you have Noctalia in ~/.config/quickshell/, you can use qs 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 full ipc call syntax, 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:

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

Discovering Commands

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

List all targets:

qs -c noctalia-shell ipc show