OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
omarchy-core low very-common DISPUTE

Fix every application being enormous on first boot

omarchyhyprlandwaylandlaptopdesktop
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

Real problem, and manual/45-troubleshooting.md confirms it, but nearly every specific is wrong. Verified against config/hypr/monitors.lua: the monitor scale default is "auto", NOT 2, so the claim that 'Hyprland's monitor scale' is 2 is false. Only GDK_SCALE=2 causes the oversizing. The file is monitors.lua, not monitors.conf, and the knob is local omarchy_gdk_scale = 2. Critically, env = GDK_SCALE,1.75 is invalid. Upstream's own comment in monitors.lua states 'GTK only honors whole numbers, so use the nearest integer to the monitor scale.' A fractional GDK_SCALE is parsed as an integer and silently becomes 1. The monitor scale 1.666667 is also wrong: upstream's commented fractional example uses 1.6, because Hyprland rejects scales that do not yield integer pixel dimensions. 'Older installs may carry GDK_SCALE=2 in hyprland.conf' is wrong. It lives in monitors.conf. And Super + / scale cycling and Ctrl + Alt + Del closing all windows do not exist in the bindings (the only Delete binding is SUPER+CTRL+ALT+Delete for display mirroring). Those appear fabricated.

The cause above was rewritten on 2026-08-30 to match this note; the fix was corrected by the audit itself.

Symptom

Right after first boot every application is enormous: text, buttons, the file manager, Spotify. Windows spill off the screen. Users on 1080p/1440p monitors say "Omarchy looks like it's zoomed to 200%".

Cause

Omarchy defaults GDK_SCALE to 2 so 4K panels are legible out of the box, and on a standard-DPI display that doubles every GTK app. Only GDK_SCALE causes the oversizing, because config/hypr/monitors.lua leaves the Hyprland monitor scale at "auto", not 2. The knob is local omarchy_gdk_scale = 2 in that same file. GTK honours only whole numbers, so a fractional GDK_SCALE is parsed as an integer and silently becomes 1.

Fix

Omarchy assumes a 2x HiDPI display. The compositor's monitor scale is already "auto". The thing making apps enormous on a 1x display is GDK_SCALE, which Omarchy sets to 2 for GTK/XWayland windows.

Edit ~/.config/hypr/monitors.lua and change the GDK scale to 1:


local omarchy_gdk_scale = 1
hl.env("GDK_SCALE", tostring(omarchy_gdk_scale))

GDK_SCALE is integer-only. GTK honors whole numbers and nothing else, so never set 1.5 or 1.75 (they are read as 1). Use the nearest integer to your monitor scale.

For a 27"/32" 4K panel where 2x is too big and 1x is too small, use a fractional *monitor* scale with an integer GDK scale. Hyprland rejects fractional scales that do not produce whole-pixel dimensions, so use 1.6 (upstream's own suggested value), not 1.666667:


local omarchy_monitor_scale = 1.6
hl.monitor({ output = "", mode = "preferred", position = "auto", scale = omarchy_monitor_scale })

local omarchy_gdk_scale = 2
hl.env("GDK_SCALE", tostring(omarchy_gdk_scale))

Apply:


hyprctl reload

GDK_SCALE only reaches apps started *after* the change, so quit and relaunch anything still oversized.

For Spotify specifically, shrink the UI in-app with Ctrl + Minus (Ctrl + Plus to grow it).

On an older Omarchy 3 install the same two knobs live in ~/.config/hypr/monitors.conf as env = GDK_SCALE,1 and monitor=,preferred,auto,1.

Verify

hyprctl monitors | grep scale shows the new value and newly launched GTK apps render at normal size.

Sources

everything-too-big-gdk-scale