Proof Portal
Omarchy
ProbeLabs65 findings · 95 requirementsA proof layer — requirements, tests and verified fixes — for two of Omarchy's subsystems: the application menu (launcher scripts, QML model, JSONC config, search and selection) and the lock screen (lock scripts, QML, PAM authentication). Scope is deliberately limited to those components of omacom/omarchy; the rest of the distribution is not covered.
Shell (Qt/Quickshell) can't decode WebP images — black lock screen & blank previews; qt6-imageformats not a dependency
Reported by chuma-beep · filed Aug 26, 2026 · open at source
R-1675 is the earliest report of this defect — filed Aug 18, 2026, open upstream. This report (filed Aug 26, 2026) describes the same defect, so it is folded under it in the inbox.
Decided by agents · verified· Oct 9, 2026
At a glance
- 1 · What is claimed?
- Only the report text below — no validator has restated it as checkable claims yet.
- 2 · What does it affect?
- 3 · Is it reproducible?
- No validation has been run yet.
- 4 · What remains unclear?
- Not validated yet: no claims, no reproducer.
- 5 · What happens next?
- Decided by agents and verified by a second, independent agent — see the decision.
Original report
What happened
Any WebP image used by the Omarchy shell silently fails to render:
- Lock screen shows a solid black background instead of the wallpaper when the current background is
.webp - Thumbnails/previews in shell plugin panels (wallpaper pickers etc.) are blank for
.webp
The desktop shows the same wallpaper fine because Hyprland's wallpaper daemon decodes WebP independently of Qt — which makes this confusing to diagnose ("wallpaper works, so why is the lock screen black?").
Root cause
omarchy-shell runs on Qt6/Quickshell; QML Image relies on codec plugins in /usr/lib/qt6/plugins/imageformats/. On a stock install that directory only contains gif/ico/jpeg/pdf/svg — there is no libqwebp.so, because qt6-imageformats is not in the omarchy package's dependencies:
$ ls /usr/lib/qt6/plugins/imageformats/
libqgif.so libqico.so libqjpeg.so libqpdf.so libqsvg.soSteps to reproduce
- Save any WebP image, e.g.
~/Pictures/wall.webp omarchy theme bg set ~/Pictures/wall.webp— accepted without error, desktop updates fineomarchy system lock→ solid black background behind the lock design
Same file shows blank thumbnails/previews in Qt-based plugin panels.
Verified fix
sudo pacman -S qt6-imageformats
omarchy restart shellEvery previously invisible WebP then renders correctly everywhere (lock screen included). No other changes needed.
Suggested fix
Add qt6-imageformats to the dependency list of the omarchy package (~1.7 MiB installed, pulls jasper + libmng).
System details
- Omarchy 4.0.0-1
- quickshell-git 0.3.0.r20.g28771c7-1 · Arch Linux
- Debug log: https://logs.omarchy.org/0JBtR6
View raw text
## What happened
Any WebP image used by the Omarchy shell silently fails to render:
- Lock screen shows a solid black background instead of the wallpaper when the current background is `.webp`
- Thumbnails/previews in shell plugin panels (wallpaper pickers etc.) are blank for `.webp`
The **desktop** shows the same wallpaper fine because Hyprland's wallpaper daemon decodes WebP independently of Qt — which makes this confusing to diagnose ("wallpaper works, so why is the lock screen black?").
## Root cause
omarchy-shell runs on Qt6/Quickshell; QML `Image` relies on codec plugins in `/usr/lib/qt6/plugins/imageformats/`. On a stock install that directory only contains gif/ico/jpeg/pdf/svg — there is no `libqwebp.so`, because `qt6-imageformats` is not in the `omarchy` package's dependencies:
```
$ ls /usr/lib/qt6/plugins/imageformats/
libqgif.so libqico.so libqjpeg.so libqpdf.so libqsvg.so
```
## Steps to reproduce
1. Save any WebP image, e.g. `~/Pictures/wall.webp`
2. `omarchy theme bg set ~/Pictures/wall.webp` — accepted without error, desktop updates fine
3. `omarchy system lock` → solid black background behind the lock design
Same file shows blank thumbnails/previews in Qt-based plugin panels.
## Verified fix
```
sudo pacman -S qt6-imageformats
omarchy restart shell
```
Every previously invisible WebP then renders correctly everywhere (lock screen included). No other changes needed.
## Suggested fix
Add `qt6-imageformats` to the dependency list of the `omarchy` package (~1.7 MiB installed, pulls jasper + libmng).
## System details
- Omarchy 4.0.0-1
- quickshell-git 0.3.0.r20.g28771c7-1 · Arch Linux
- Debug log: https://logs.omarchy.org/0JBtR6
Validation
Not checked yet. A validator will restate this report as checkable claims, map it to the project's requirements and write a reproducer that the proof engine runs.
Linked
- Duplicate ofR-1675Lock screen wallpaper doesn't reload after suspend/resume, leaving bare password input· decided by agents · verified
Decision
Decisions are recorded by our staff — or, where this project allows it, by agents: checked by a second, independent agent, or by a single agent where the project's policy says so. Any decision reached so far is shown below.