Fix a high-resolution wallpaper looking grainy as the Omarchy background
Confirmed on this 4.0.4-1 workstation: Background.qml's base Image at line 221 sets fillMode PreserveAspectCrop and neither smooth nor mipmap, while the two transition frames set smooth: true and mipmap: true. imagemagick 7.1.2.31-1 is installed and omarchy-bar-text-color calls magick. PR #13408 merged to quattro on 2026-09-27, and a maintainer comment on #13958 says it replaces the base Image with BackgroundMedia using a screen-size sourceSize. Releases API shows v4.0.4 is still latest. The cause and the pre-scale fix hold. One fabricated specific in the fix: 'A cloned bar plugin is known to remove the bar entirely' is not in either cited source. The reporter of #13958 actually cloned the background plugin with smooth and mipmap set and says the grain went away. Replaced that paragraph with what the source supports and the real cost of a clone. The magick command was not run.
Symptom
A large wallpaper (for example a 6000x3274 PNG) looks noisy and grainy as my desktop background, worst in dark areas and skies. The same file opened in an image viewer is perfectly clean.
Cause
In /usr/share/omarchy/shell/plugins/background/Background.qml on 4.0.4-1, the main base Image (line 221) does not set mipmap: true, while the two transition frames (lines 237 and 263) do. smooth defaults to true in Qt Quick, so the base frame is filtered bilinearly. Bilinear filtering of a texture several times larger than the screen reads only a few source pixels for each screen pixel, so fine detail aliases into grain. The base Image also has no sourceSize, so the full-resolution image is uploaded as the texture. Upstream #13408, merged to quattro on 2026-09-27 and not in 4.0.4, decodes backgrounds at screen size and removes the cause.
Fix
Pre-scale the wallpaper to your monitor size, which takes the downscale out of the shell. ImageMagick is already installed because the bar uses it:
hyprctl monitors -j | python3 -c 'import json,sys;[print(m["name"],m["width"],m["height"]) for m in json.load(sys.stdin)]'
theme=$(cat ~/.local/state/omarchy/current/theme.name)
mkdir -p ~/.config/omarchy/backgrounds/$theme
magick /path/to/big-wallpaper.png -resize 2560x1440^ -gravity center -extent 2560x1440 \
~/.config/omarchy/backgrounds/$theme/big-wallpaper-2560.png
omarchy theme bg set ~/.config/omarchy/backgrounds/$theme/big-wallpaper-2560.png
Replace 2560x1440 with your largest monitor's pixel size. ^ fills the area and -extent crops to it, matching the shell's PreserveAspectCrop.
The reporter of #13958 instead cloned the background plugin and set smooth: true and mipmap: true on the base image, which removed the grain. A clone stops receiving upstream fixes, including #13408, so if you take that route, remove the clone once omarchy update brings a release that contains #13408. Pre-scaling needs no clone and keeps working after that release.
Verify
The pre-scaled image shows no grain. readlink ~/.local/state/omarchy/current/background points at the new file.