OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
display-monitors medium very-common DISPUTE

Pick a fractional scale Hyprland accepts instead of 'Invalid scale'

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

The mechanism, the awk helper and the preset list are all verified correct. The awk function is byte-for-byte Omarchy quattro's clean_scale() from bin/omarchy-hyprland-monitor-scaling, SCALES=(1 1.25 1.6 2 3 4) matches exactly, and the wiki confirms the divisibility rule. The resolution-specific claims check out (1.5 valid on 1920x1080 and 3840x2160, invalid on 2560x1440, and 1.75 invalid on all three). But the worked example's stated output is wrong: gcd(2560*120,1440*120)=19200, k=210, and the smallest divisor of 19200 that is >=210 is 240, so cleanscale 1.75 2560 1440 prints 2, not 1.777. A user who sees 2 will think the helper is broken. Also omarchy hyprland monitor scaling accepts any value 1..4, not only the presets.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.

Symptom

You set a fractional scale like 1.75 and Hyprland refuses it: an "Invalid scale" / "scale is not divisible by integer" config error banner appears, or the display silently comes up at 1 or at some other scale you did not pick. Text is either too small or too big and nothing you type in the config changes it.

Cause

Hyprland only accepts a scale that turns the monitor's pixel resolution into whole logical pixels, in 1/120 steps. Formally, round(scale*120) must divide gcd(width*120, height*120). 1920x1080/1.4 = 1371.43x771.43, so 1.4 is rejected. The valid set differs per resolution: 1.5 is fine on 1920x1080 and 3840x2160 but invalid on 2560x1440, and 1.75 is invalid on all three.

Fix

Compute a clean scale for your exact mode before writing it into the config:


# usage: cleanscale <wanted> <width> <height>
cleanscale() {
  awk -v s="$1" -v w="$2" -v h="$3" '
    function gcd(a,b,t){while(b){t=a%b;a=b;b=t}return a}
    BEGIN{g=gcd(w*120,h*120);k=int(s*120+0.5);if(k>g)k=g;while(g%k!=0)k++;printf "%g\n",k/120}'
}
cleanscale 1.75 2560 1440   # -> 2      (rounds UP to the next legal value)
cleanscale 1.75 1920 1080   # -> 1.875
cleanscale 1.6  2560 1440   # -> 1.6    (already legal)

Note the helper rounds *up* to the next legal value, so a request can jump a long way (1.75 -> 2 on 1440p). Then set the value it printed (Hyprland 0.55+ / Omarchy 4, ~/.config/hypr/monitors.lua):


hl.monitor({ output = "DP-1", mode = "2560x1440@165", position = "0x0", scale = 1.6 })

On Omarchy just use the helper, which does this rounding for you and persists it:


omarchy hyprland monitor scaling 1.6    # or: up / down

up/down step through the presets 1 1.25 1.6 2 3 4. An explicit argument may be any value between 1 and 4 and is rounded to the nearest legal scale for the focused monitor.

Verify

hyprctl monitors | grep -E 'scale|^Monitor' shows the scale you asked for and no config-error banner is drawn on the screen.

Sources

hyprland-invalid-scale-not-divisible