Troubleshooting
Where to look when something does not work.
Run the doctor. It lists missing programs, and checks that Hyprland is 0.55 or newer:
./install.sh --doctorThe shell runs as a user service:
systemctl --user status quickshell
journalctl --user -u quickshell -n 50
systemctl --user restart quickshellA QML syntax error takes the whole shell down; the journal names the file and line.
Hyprland found a mistake in its config. Show it with hyprctl configerrors. If it is in user.lua,
fix or remove that line; Hyprland reloads on save.
The plugins are rebuilt automatically at the next login. Check with hypr-plugins status; build by hand
with hypr-plugins build; the build log is ~/.local/state/hypr/plugins-build.log.
If you see "Plugins skipped", Hyprland crashed during the previous start: rm ~/.local/state/hypr/plugins-starting.
A fixed accent colour is set. Choose Wallpaper in Settings → Appearance.
Press Win+W and pick a wallpaper, or run setwall ~/Pictures/Wallpapers/evening-sky.png.
Pin the mode in ~/.config/hypr/user.lua, see Customise.
./uninstall.sh removes everything the installer copied and restores your previous configs from the backup.