Proof Portal

Sign in
Project overview

Omarchy

ProbeLabs65 findings · 95 requirements

A 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.

Inbox
ReportR-1425GitHub issuePublicDecided· Out of scope

Shell restart buries external animated wallpapers — omarchy-background remaps above existing layer-shell background layers

Reported by ChimeraMind · filed Aug 26, 2026 · open at source

Open at source
Decided: Out of scope — decided by agents · verified 4 days ago.

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?
AreaOutside the audited area· Decided by agents · verified
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

Shell restart buries external animated wallpapers — omarchy-background remaps above existing layer-shell background layersrevision 1 · captured 2026-09-28 21:24 UTC via poll

Summary

Any Omarchy shell restart (crash recovery, omarchy restart shell, shell updates) re-maps the shell's omarchy-background layer above pre-existing third-party background layers, silently hiding animated wallpapers behind the static theme image. No error is shown; the wallpaper just "stops". Omarchy v4 has no native animated-wallpaper support, so mpvpaper is the community-standard way to run video wallpapers — and every shell restart currently breaks them.

Environment

  • Hardware: Steam Deck LCD (VanGogh APU), docked (2560×1080 + panel). Omarchy-on-Deck is still rare — and Deck users coming from SteamOS expect video wallpapers to just keep working.
  • Omarchy 4.0.0.alpha, Hyprland 0.56.2, mpvpaper 1.9

Steps to reproduce

  1. Start an animated wallpaper as a layer-shell background: mpvpaper -o "loop=inf no-audio" '*' video.mp4 — video visible, hyprctl layers shows mpvpaper after omarchy-background (on top)
  2. Run omarchy restart shell
  3. Video is gone — hyprctl layers now shows the new shell's omarchy-background after mpvpaper (on top), painting the static theme image over it

Confirmed on both monitors; reproduced 100% of attempts. Not reproducible via omarchy-shell background set IPC alone (tested — same layer addresses persist); it's specifically the shell restart remapping.

Expected

Either the shell's background layer preserves stacking relative to existing background-namespace layers, or the interplay is documented with a supported hook for restarting external wallpaper services after shell startup.

Workaround

Restart the wallpaper service after every shell restart (re-maps its layer on top). Automating this currently requires scraping journal/IPC for shell restarts.

Happy to test patches on the Deck.

View raw text
## Summary

Any Omarchy shell restart (crash recovery, `omarchy restart shell`, shell updates) re-maps the shell's `omarchy-background` layer **above** pre-existing third-party background layers, silently hiding animated wallpapers behind the static theme image. No error is shown; the wallpaper just "stops". Omarchy v4 has no native animated-wallpaper support, so `mpvpaper` is the community-standard way to run video wallpapers — and every shell restart currently breaks them.

## Environment

- **Hardware: Steam Deck LCD (VanGogh APU), docked** (2560×1080 + panel). Omarchy-on-Deck is still rare — and Deck users coming from SteamOS expect video wallpapers to just keep working.
- Omarchy 4.0.0.alpha, Hyprland 0.56.2, mpvpaper 1.9

## Steps to reproduce

1. Start an animated wallpaper as a layer-shell background: `mpvpaper -o "loop=inf no-audio" '*' video.mp4` — video visible, `hyprctl layers` shows `mpvpaper` after `omarchy-background` (on top)
2. Run `omarchy restart shell`
3. Video is gone — `hyprctl layers` now shows the new shell's `omarchy-background` **after** `mpvpaper` (on top), painting the static theme image over it

Confirmed on both monitors; reproduced 100% of attempts. Not reproducible via `omarchy-shell background set` IPC alone (tested — same layer addresses persist); it's specifically the shell restart remapping.

## Expected

Either the shell's background layer preserves stacking relative to existing background-namespace layers, or the interplay is documented with a supported hook for restarting external wallpaper services after shell startup.

## Workaround

Restart the wallpaper service after every shell restart (re-maps its layer on top). Automating this currently requires scraping journal/IPC for shell restarts.

Happy to test patches on the Deck.

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

  • Related PRpr/12459· confirmed

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.

  • Out of scopeDecided by agents · verified · 2026-10-09 09:16 UTC