OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
omarchy-theming low occasional DISPUTE

Fix a high-resolution wallpaper looking grainy as the Omarchy background

omarchywallpaperquickshell
CORRECTED An auditor found the fix wrong or incomplete and rewrote it. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

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.

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

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.

Sources

wallpaper-grainy-large-image-no-mipmaps