The first step is to install the noctalia-shell package in the terminal.
pikman install noctalia-shell
Optionally before editing configuration files backup your previous configuration located in:
~/.config/hypr/exec.confRemove or comment out (
#) the following line:
exec-once=pikabar
Add the following to your ~/.config/hypr/exec.conf
exec-once = qs -c noctalia-shell
Modify your keybind in ~/.config/hypr/keybinds.conf
Old configuration:
bind=$mainMod,D,exec,walker
New configuration:
bind=$mainMod,D,exec,qs -c ipc call launcher toggle
Restart your session to see the changes.
Optionally before editing configuration files backup your previous configuration located in:
Open ~/.config/niriconfig.kdl.
Remove or comment out (//) the following lines
spawn-at-startup "pikabar"
optionally you can disable swww sinds noctalia comes with its own wallpaper manager
Remove or comment out (//) the following lines
spawn-at-startup "swww-daemon"
Add the following line to ~/.config/niri/config.kdl
spawn-at-startup "qs" "-c" "noctalia-shell"
Noctalia uses its own launcher. Replace the default keybind in ~/.config/niri/config.kdl.
Old configuration:
Mod+D { spawn "pikabar-launcher"; }
New configuration:
Mod+D { spawn "qs" "-c" "noctalia-shell" "ipc" "call" "launcher" "toggle"; }
To ensure the wallpaper layer renders correctly, add or adjust the following layer-rule:
layer-rule {
match namespace="^noctalia-wallpaper*"
place-within-backdrop true
}
Restart your session to see the changes.
Check out the official Noctalia Wiki for additional background and overview configuration options.