Hyprland customizations silently revert after the Quattro upgrade because ~/.config/hypr/*.conf is no longer read
Cause verified line-for-line. hypr.land/news/26_lua: "if you don't have a hyprland.lua config file, your old hyprland.conf will be loaded... However, if you do have one, hyprland.lua will be loaded instead. This check is only done once at startup", plus "Other hypr* tools will for now continue using hyprlang", which validates leaving hyprsunset.conf/xdph.conf alone. The always_copy_config_files list in omarchy-upgrade-to-quattro (L1631) matches the record exactly (hypr/.luarc.json, autostart.lua, bindings.lua, hyprland.lua, input.lua, looknfeel.lua, monitors.lua). default/hypr/input.lua really does read local kb_layout = vconsole.XKBLAYOUT or "us". default/hypr/helpers.lua really defines global o = o or {}, and upstream config/hypr/hyprland.lua does NOT require it directly (it goes bootstrap -> require("default.hypr.omarchy")), so the missing-require diagnosis is correct, and bootstrap.lua puts ~/.config/?.lua and $OMARCHY_PATH/?.lua on package.path so the require resolves. Every Lua line in the fix is copied verbatim from upstream's own commented examples (hl.monitor / hl.env / hl.config / o.bind / hl.unbind / o.launch_on_start). Issues #6878 and #5879 are real and titled exactly as described. Two defects: (1) hyprctl getoption input:kb_layout uses the retired hyprlang colon syntax: wiki.hypr.land's hyprctl page now states "the option name should be written as section.option" with examples general.border_size and input.touchpad.disable_while_typing, so it must be input.kb_layout. The colon form is exactly the kind of stale pre-Lua syntax that should not ship. (2) For the most-reported symptom (#6878, layout reverting to US) the record only offers hardcoding kb_layout in input.lua, and never mentions the one-line root-cause fix: populate XKBLAYOUT in /etc/vconsole.conf, which the packaged default already reads. ArchWiki Xorg/Keyboard_configuration confirms "localectl additionally writes the keyboard configuration to /etc/vconsole.conf using variables XKBLAYOUT, XKBMODEL, XKBVARIANT and XKBOPTIONS".
hyprlock and hypridle deliberately stayed on hyprlang. The Hyprland announcement says "Other hypr* tools will for now continue using hyprlang as their config language provider." Do not convert hyprlock.conf to Lua while porting. A broken hyprlock config locks you out of a running session. omarchy-refresh-config overwrites the target file (it does write a .bak.<epoch> first). Move the legacy .conf files rather than deleting them until you have confirmed every setting is ported.
Symptom
"After upgrading to Omarchy 4 all my Hyprland tweaks are gone." Custom keybinds, monitor resolution/refresh/scale, keyboard layout (an AZERTY/QWERTZ session comes back as US QWERTY), touchpad natural scrolling and exec-once autostarts all revert to stock, but ~/.config/hypr/hyprland.conf, bindings.conf, input.conf, monitors.conf, looknfeel.conf are still sitting on disk with the settings in them.
A subset of users instead get a black screen with a red Hyprland error banner:
attempt to index a nil value (global 'o')
referencing default/hypr/autostart.lua:1, default/hypr/bindings/media.lua:2, default/hypr/bindings/clipboard.lua:13, default/hypr/windows.lua:3.
Cause
Hyprland 0.55 deprecated hyprlang in favour of Lua. It loads $XDG_CONFIG_HOME/hypr/hyprland.lua when that file exists and only falls back to hyprland.conf when it does not. omarchy-upgrade-to-quattro unconditionally installs the stock Quattro entry points, and its always_copy_config_files list is hypr/hyprland.lua, hypr/bindings.lua, hypr/input.lua, hypr/looknfeel.lua, hypr/monitors.lua, hypr/autostart.lua, hypr/.luarc.json. It deliberately leaves the legacy .conf files alone ("Hyprland .conf files are intentionally left in place for users to reference/port after the upgrade"). The moment hyprland.lua exists, every .conf it used to source is dead weight.
The keyboard layout is a special case: the packaged default/hypr/input.lua reads local kb_layout = vconsole.XKBLAYOUT or "us". Most installs have only KEYMAP=fr in /etc/vconsole.conf and no XKBLAYOUT, so the layout silently falls back to us (issue #6878).
The global 'o' crash is different: it hits people who already hand-wrote a hyprland.lua on an earlier release whose entrypoint never called require("default.hypr.helpers"), which is where the o helper table is defined. No migration backfills that line (issue #5879).
Fix
Your old settings are still readable. Port them block by block into the Lua files Omarchy now loads.
ls -l ~/.config/hypr/*.conf # the settings you are missing are in here
**Keyboard layout first. It has a one-line root-cause fix.** Omarchy's packaged default/hypr/input.lua reads vconsole.XKBLAYOUT or "us", and most installs only have KEYMAP= set. Give it the variable it is looking for and the layout comes back everywhere (Hyprland, TTY, initramfs prompt):
grep -E 'KEYMAP|XKB' /etc/vconsole.conf # likely KEYMAP=fr and no XKBLAYOUT
sudo localectl set-x11-keymap fr # writes XKBLAYOUT=fr to /etc/vconsole.conf
# with a variant/options, e.g.:
# sudo localectl set-x11-keymap fr "" azerty compose:caps
grep -E 'XKB' /etc/vconsole.conf
hyprctl reload && hyprctl getoption input.kb_layout
Then port the rest:
-- ~/.config/hypr/monitors.lua
-- old: monitor = DP-2,2560x1440@144,0x0,1
hl.monitor({ output = "DP-2", mode = "2560x1440@144", position = "0x0", scale = 1 })
-- old: env = GDK_SCALE,2
hl.env("GDK_SCALE", "2")
-- ~/.config/hypr/input.lua (only if you want to override vconsole.conf here)
-- old: input { kb_layout = fr; kb_options = compose:caps; touchpad { natural_scroll = true } }
hl.config({
input = {
kb_layout = "fr",
kb_variant = "",
kb_options = "compose:caps",
accel_profile = "flat",
touchpad = { natural_scroll = true, disable_while_typing = false },
},
})
-- ~/.config/hypr/bindings.lua
-- old: bind = SUPER SHIFT, R, exec, alacritty -e ssh your-server
o.bind("SUPER + SHIFT + R", "SSH", "alacritty -e ssh your-server")
-- old: unbind = SUPER SHIFT, B
hl.unbind("SUPER + SHIFT + B")
-- ~/.config/hypr/looknfeel.lua
-- old: general { gaps_in = 0; gaps_out = 0; border_size = 0 }
hl.config({ general = { gaps_in = 0, gaps_out = 0, border_size = 0 } })
-- ~/.config/hypr/autostart.lua
-- old: exec-once = my-service
o.launch_on_start("my-service")
Apply and check without logging out. Note that on Hyprland 0.55+ getoption takes section.option with **dots**. The old input:kb_layout colon form is hyprlang syntax and no longer correct:
hyprctl reload
hyprctl getoption input.kb_layout
hyprctl getoption input.touchpad.natural_scroll
hyprctl monitors
hyprctl binds | grep -B2 -A2 'SSH'
hyprctl configerrors
# try a setting live before writing it to a file:
hyprctl repl
For the global 'o' crash, either add the missing require to your own ~/.config/hypr/hyprland.lua right after the bootstrap/paths line:
dofile((os.getenv("OMARCHY_PATH") or "/usr/share/omarchy") .. "/default/hypr/bootstrap.lua")
require("default.hypr.helpers")
require("default.hypr.omarchy")
or reset to the shipped entrypoint (it saves yours as hyprland.lua.bak.<epoch> and prints the diff):
omarchy-refresh-config hypr/hyprland.lua
Once ported, get the dead files out of the way, but leave hyprsunset.conf and xdph.conf, whose tools are still hyprlang:
mkdir -p ~/.config/hypr/legacy-conf
mv ~/.config/hypr/hyprland.conf ~/.config/hypr/bindings.conf ~/.config/hypr/input.conf \
~/.config/hypr/monitors.conf ~/.config/hypr/looknfeel.conf ~/.config/hypr/autostart.conf \
~/.config/hypr/envs.conf ~/.config/hypr/legacy-conf/ 2>/dev/null
Verify
hyprctl getoption input:kb_layout reports your layout. hyprctl monitors shows the right mode/scale. hyprctl binds lists your custom binds. No red error banner at login.
Sources
- https://raw.githubusercontent.com/basecamp/omarchy/master/bin/omarchy-upgrade-to-quattro
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/config/hypr/hyprland.lua
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/config/hypr/monitors.lua
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/config/hypr/input.lua
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/config/hypr/bindings.lua
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/config/hypr/looknfeel.lua
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/config/hypr/autostart.lua
- https://raw.githubusercontent.com/basecamp/omarchy/quattro/bin/omarchy-refresh-config
- https://github.com/basecamp/omarchy/issues/6878
- https://github.com/basecamp/omarchy/issues/5879
- https://hypr.land/news/26_lua/