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-5327GitHub issuePublicDecided· Duplicate

[Shell] Qt 6.12 upgrade breaks Commons Color singleton (shadowed by QtQuick Color), causing black screen on menu and broken volume OSD

Reported by dannie203 · filed Oct 11, 2026 · open at source

Open at source
Decided: Duplicate — decided by agents · verified 24 h ago.
Duplicate ofMenu is black after Qt 6.12.0 / quickshell 0.3.2 upgrade (Color singleton sub-objects undefined) R-5254

R-5254 is the earliest report of this defect — filed Oct 8, 2026, open upstream. This report (filed Oct 11, 2026) describes the same defect, so it is folded under it in the inbox.

Decided by agents · verified· Oct 11, 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?
AreaPartly in the audited areamenulock· 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] Qt 6.12 upgrade breaks Commons Color singleton (shadowed by QtQuick Color), causing black screen on menu and broken volume OSDrevision 1 · captured 2026-10-11 07:41 UTC via poll

Summary

After upgrading to qt6-declarative 6.12.0-1 (and quickshell 0.3.2-1), opening the Omarchy menu (omarchy-menu toggle via SUPER + SPACE or SUPER + ESCAPE) causes a pitch-black screen with locked focus, and volume/brightness key adjustments fail to render the on-screen display (OSD).

Environment

  • OS: Arch Linux (Omarchy Quattro 4.0.4-1)
  • Hyprland: 0.44+
  • Quickshell: 0.3.2-1
  • Qt Version: qt6-declarative 6.12.0-1

Root Cause

In Qt 6.12, QtQuick introduced a global Color value type / namespace.
In /usr/share/omarchy/shell/Commons/qmldir, the theme singleton is named Color:

singleton Color 1.0 Color.qml

When QML components import both QtQuick and qs.Commons, bare Color resolves to QtQuick.Color (QQuickColor) instead of qs.Commons.Color.
Consequently:
- Color.menu evaluates to undefined, causing Menu.qml to fail rendering its card. Only the full-screen black overlay (scrim) with WlrKeyboardFocus.Exclusive is shown, trapping the user in a black screen.
- Color.popups evaluates to undefined, causing Osd.qml to crash with TypeErrors (Cannot read property 'text' of undefined), so the volume/brightness OSD fails to show.
- Color.tooltip, Color.lock, and Color.polkit similarly throw TypeErrors.

Proposed Solution

  1. Rename the singleton in Commons/qmldir (e.g. singleton ThemeColor 1.0 Color.qml or OmarchyColor) and update references throughout /usr/share/omarchy/shell/.
  2. Or use namespaced imports: import qs.Commons as Commons and refer to Commons.Color.*.

Temporary Workaround

Downgrade qt6-* to 6.11.2 and quickshell to 0.3.1-1.

View raw text
### Summary
After upgrading to `qt6-declarative 6.12.0-1` (and `quickshell 0.3.2-1`), opening the Omarchy menu (`omarchy-menu toggle` via `SUPER + SPACE` or `SUPER + ESCAPE`) causes a pitch-black screen with locked focus, and volume/brightness key adjustments fail to render the on-screen display (OSD).

### Environment
- **OS:** Arch Linux (Omarchy Quattro 4.0.4-1)
- **Hyprland:** 0.44+
- **Quickshell:** 0.3.2-1
- **Qt Version:** `qt6-declarative 6.12.0-1`

### Root Cause
In Qt 6.12, `QtQuick` introduced a global `Color` value type / namespace.
In `/usr/share/omarchy/shell/Commons/qmldir`, the theme singleton is named `Color`:
```qml
singleton Color 1.0 Color.qml
```
When QML components import both `QtQuick` and `qs.Commons`, bare `Color` resolves to `QtQuick.Color` (`QQuickColor`) instead of `qs.Commons.Color`.
Consequently:
- `Color.menu` evaluates to `undefined`, causing `Menu.qml` to fail rendering its card. Only the full-screen black overlay (`scrim`) with `WlrKeyboardFocus.Exclusive` is shown, trapping the user in a black screen.
- `Color.popups` evaluates to `undefined`, causing `Osd.qml` to crash with TypeErrors (`Cannot read property 'text' of undefined`), so the volume/brightness OSD fails to show.
- `Color.tooltip`, `Color.lock`, and `Color.polkit` similarly throw TypeErrors.

### Proposed Solution
1. Rename the singleton in `Commons/qmldir` (e.g. `singleton ThemeColor 1.0 Color.qml` or `OmarchyColor`) and update references throughout `/usr/share/omarchy/shell/`.
2. Or use namespaced imports: `import qs.Commons as Commons` and refer to `Commons.Color.*`.

### Temporary Workaround
Downgrade `qt6-*` to `6.11.2` and `quickshell` to `0.3.1-1`.

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

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.

  • DuplicateR-5254Decided by agents · verified · 2026-10-11 07:57 UTC