Proof Portal

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-1183GitHub issuePublicDecided· Out of scope

Internal panel stays black after screensaver/suspend wake on single-GPU Nvidia laptops (dpmsStatus desync in omarchy-brightness-display)

Reported by ahdkabeerhadi · filed Aug 31, 2026 · 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

Internal panel stays black after screensaver/suspend wake on single-GPU Nvidia laptops (dpmsStatus desync in omarchy-brightness-display)revision 1 · captured 2026-09-28 21:24 UTC via poll

What happened

On a laptop with a single Nvidia dGPU (no hybrid iGPU) driving both the internal panel and an external monitor, the internal (eDP-1) display goes black and never recovers after either:

  • the idle screensaver/lock timeout fires and is later dismissed, or
  • the system does a real suspend/resume (lid close or manual suspend)

The external monitor keeps working fine in both cases, and the mouse cursor can be moved onto the dead internal panel — the compositor is alive and thinks the output is active, it just isn't putting anything on screen. Only a full reboot recovers the panel.

System details

  • Omarchy version: 4.0.1-1
  • Kernel: 7.1.9-arch1-2
  • GPU: NVIDIA GeForce RTX 5060 Max-Q (GB206M), single dGPU, no hybrid graphics
  • Driver: nvidia-open-dkms / nvidia-utils 610.57.04-1 (GSP path)
  • Internal panel: Samsung Display Corp. ATNA60HS03-0 (eDP-1)
  • External: LG Ultrawide (HDMI-A-1)
  • ~/.config/hypr/monitors.lua generated by nwg-displays, two hl.monitor() entries, no per-monitor DPMS overrides

Root cause (traced in source)

Both wake paths funnel through the same script: omarchy-system-wake -> omarchy-brightness-display on. Its on handler (/usr/share/omarchy/bin/omarchy-brightness-display) contains:

elif [[ $step == "on" ]]; then
  # Skip the dispatch when every active display is already lit: a redundant
  # DPMS enable right after system resume forces another modeset, which blanks
  # the panel for a beat (visible flash at the unlock screen).
  hyprctl monitors -j 2>/dev/null | jq -e '[.[] | select(.disabled == false)] | length > 0 and all(.dpmsStatus)' >/dev/null 2>&1 && exit 0
  hyprctl dispatch 'hl.dsp.dpms({ action = "enable" })' >/dev/null 2>&1
  exit 0
fi

This skips the real hl.dsp.dpms({ action = "enable" }) call whenever hyprctl monitors -j already reports dpmsStatus: true on every active output — intended to avoid a double-modeset flash.

On this hardware that flag lies. I captured a live hyprctl monitors dump while the internal panel was physically black:

Monitor eDP-1 (ID 1):
	[email protected] at 3440x255
	...
	disabled: false
	dpmsStatus: 1

dpmsStatus reads 1 (on) even though nothing is being scanned out to the panel — almost certainly an Nvidia KMS quirk where the reported DPMS state doesn't reflect whether the modeset actually landed. Because omarchy-brightness-display on trusts this flag with no verification and no fallback, the real re-enable dispatch that would fix the panel never fires, and the compositor has no reason to try again.

This explains why it happens after both idle-screensaver dismissal and real suspend/resume — both call the exact same omarchy-system-wake -> omarchy-brightness-display on path (idle-triggered wake via Service.qml's cancelIdleCycle, and post-suspend wake via the lock plugin's runWake() on password entry).

Expected

The internal panel should reliably come back after screensaver dismissal and after suspend/resume, without requiring a reboot.

Suggested fix direction

Don't trust dpmsStatus alone as proof the panel is actually lit. Options:
- Always issue the hl.dsp.dpms({ action = "enable" }) call on wake (accept the occasional flash) rather than skipping based on a driver-reported flag known to desync on Nvidia.
- Or verify actual scanout state (e.g. compare a frame checksum / render timestamp) before trusting dpmsStatus.
- Or, as a narrower fix, exclude Nvidia-driven outputs from the "skip if already lit" optimization.

Secondary finding (real suspend hygiene)

Separately, Omarchy's Nvidia installer (/usr/share/omarchy/install/hardware/nvidia.sh) sets nvidia_drm modeset=1 but never enables nvidia-suspend.service / nvidia-resume.service / nvidia-hibernate.service, nor sets NVreg_PreserveVideoMemoryAllocations=1. These are shipped by nvidia-utils specifically to preserve video memory allocations across suspend and are generally required for reliable Nvidia suspend/resume on Linux. Worth enabling by default for Nvidia installs regardless of the DPMS bug above.

Diagnostics

  • omarchy version: 4.0.1-1
  • lspci -k GPU line: 01:00.0 VGA compatible controller: NVIDIA Corporation GB206M [GeForce RTX 5060 Max-Q / Mobile] (rev a1), driver in use: nvidia
  • Live hyprctl monitors capture showing dpmsStatus: 1 on a physically black eDP-1 available on request
View raw text
## What happened

On a laptop with a single Nvidia dGPU (no hybrid iGPU) driving both the internal panel and an external monitor, the internal (`eDP-1`) display goes black and never recovers after **either**:

- the idle screensaver/lock timeout fires and is later dismissed, or
- the system does a real suspend/resume (lid close or manual suspend)

The external monitor keeps working fine in both cases, and the mouse cursor can be moved onto the dead internal panel — the compositor is alive and thinks the output is active, it just isn't putting anything on screen. Only a full reboot recovers the panel.

## System details

- Omarchy version: 4.0.1-1
- Kernel: 7.1.9-arch1-2
- GPU: NVIDIA GeForce RTX 5060 Max-Q (GB206M), single dGPU, no hybrid graphics
- Driver: nvidia-open-dkms / nvidia-utils 610.57.04-1 (GSP path)
- Internal panel: Samsung Display Corp. ATNA60HS03-0 (eDP-1)
- External: LG Ultrawide (HDMI-A-1)
- `~/.config/hypr/monitors.lua` generated by nwg-displays, two `hl.monitor()` entries, no per-monitor DPMS overrides

## Root cause (traced in source)

Both wake paths funnel through the same script: `omarchy-system-wake` -> `omarchy-brightness-display on`. Its `on` handler (`/usr/share/omarchy/bin/omarchy-brightness-display`) contains:

```bash
elif [[ $step == "on" ]]; then
  # Skip the dispatch when every active display is already lit: a redundant
  # DPMS enable right after system resume forces another modeset, which blanks
  # the panel for a beat (visible flash at the unlock screen).
  hyprctl monitors -j 2>/dev/null | jq -e '[.[] | select(.disabled == false)] | length > 0 and all(.dpmsStatus)' >/dev/null 2>&1 && exit 0
  hyprctl dispatch 'hl.dsp.dpms({ action = "enable" })' >/dev/null 2>&1
  exit 0
fi
```

This skips the real `hl.dsp.dpms({ action = "enable" })` call whenever `hyprctl monitors -j` already reports `dpmsStatus: true` on every active output — intended to avoid a double-modeset flash.

On this hardware that flag lies. I captured a live `hyprctl monitors` dump while the internal panel was physically black:

```
Monitor eDP-1 (ID 1):
	[email protected] at 3440x255
	...
	disabled: false
	dpmsStatus: 1
```

`dpmsStatus` reads `1` (on) even though nothing is being scanned out to the panel — almost certainly an Nvidia KMS quirk where the reported DPMS state doesn't reflect whether the modeset actually landed. Because `omarchy-brightness-display on` trusts this flag with no verification and no fallback, the real re-enable dispatch that would fix the panel never fires, and the compositor has no reason to try again.

This explains why it happens after *both* idle-screensaver dismissal and real suspend/resume — both call the exact same `omarchy-system-wake` -> `omarchy-brightness-display on` path (idle-triggered wake via `Service.qml`'s `cancelIdleCycle`, and post-suspend wake via the lock plugin's `runWake()` on password entry).

## Expected

The internal panel should reliably come back after screensaver dismissal and after suspend/resume, without requiring a reboot.

## Suggested fix direction

Don't trust `dpmsStatus` alone as proof the panel is actually lit. Options:
- Always issue the `hl.dsp.dpms({ action = "enable" })` call on wake (accept the occasional flash) rather than skipping based on a driver-reported flag known to desync on Nvidia.
- Or verify actual scanout state (e.g. compare a frame checksum / render timestamp) before trusting `dpmsStatus`.
- Or, as a narrower fix, exclude Nvidia-driven outputs from the "skip if already lit" optimization.

## Secondary finding (real suspend hygiene)

Separately, Omarchy's Nvidia installer (`/usr/share/omarchy/install/hardware/nvidia.sh`) sets `nvidia_drm modeset=1` but never enables `nvidia-suspend.service` / `nvidia-resume.service` / `nvidia-hibernate.service`, nor sets `NVreg_PreserveVideoMemoryAllocations=1`. These are shipped by `nvidia-utils` specifically to preserve video memory allocations across suspend and are generally required for reliable Nvidia suspend/resume on Linux. Worth enabling by default for Nvidia installs regardless of the DPMS bug above.

## Diagnostics

- `omarchy version`: 4.0.1-1
- `lspci -k` GPU line: `01:00.0 VGA compatible controller: NVIDIA Corporation GB206M [GeForce RTX 5060 Max-Q / Mobile] (rev a1)`, driver in use: `nvidia`
- Live `hyprctl monitors` capture showing `dpmsStatus: 1` on a physically black `eDP-1` available on request

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

Not linked to any known issue, other report or change yet.

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 10:14 UTC