Configuration
Autostart
Learn how to configure caffyne shell to hook into your compositor session.
To ensure your shell spins up immediately when logging into your graphic environment, configure it inside your Wayland compositor initialization file.
Niri Configuration
Add the startup executor hook into your main config.kdl or configuration layout file:
config.kdl
spawn-at-startup "~/.config/caffyne-shell/start.sh"
Hyprland Configuration
If executing inside a Hyprland workspace, bind the startup executable inside your script tree:
hyprland.conf
exec-once = ~/.config/caffyne-shell/start.sh
Always ensure that execution access is granted to the helper script. Run
chmod +x ~/.config/caffyne-shell/start.sh if it fails to automatically spawn.