Skip to Content
MvpDots

Customise

Recipes for the most common changes, each shown as a diff, in places updates never overwrite.

Where changes go

Hyprland reads its config in this order; later files win:

hyprland.lua — the base config (updated by the installer)
colors.lua — generated from the wallpaper
plugins.lua — optional plugins
keys.lua — your shortcuts from Settings → Keyboard
look.lua — generated by Settings → Windows & Effects
hyprland-gui.lua — written by HyprMod, if you use it
user.lua — yours: never touched by updates

Rule of thumb

Use Settings when it has the option. Put everything else in ~/.config/hypr/user.lua. Don't edit hyprland.lua itself: the next update would replace it.

Hyprland reloads on save. After any edit, check for mistakes:

Terminal
hyprctl configerrors     # empty = all good

Recipes

What Settings writes

Settings → Windows & Effects stores only the values you change in look.json, then generates look.lua. Delete both to go back to hyprland.lua's values.

~/.config/hypr/look.lua (generated)
-- Generated by Settings → Windows & Effects (HyprLook.qml). Do not edit by hand:
-- change it in Settings, or delete this file to go back to hyprland.lua's values.
hl.config({
    decoration = {
        blur = { brightness = 1.15, contrast = 2, noise = 0.01, xray = false },
        shadow = { range = 30, render_power = 4 },
        rounding = 20,
    },
    general = { border_size = 0 },
})

Editing the shell

The shell lives in ~/.config/quickshell/ (shell.qml is the entry point, one .qml file per piece). A syntax error takes the whole bar down, so check before saving:

Terminal
/usr/lib/qt6/bin/qmllint ~/.config/quickshell/Island.qml
journalctl --user -u quickshell -n 30     # look for "Configuration Loaded"
systemctl --user restart quickshell       # if it didn't reload by itself

On this page