OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
display-monitors medium common DISPUTE

HDR / 10-bit enabled: washed-out SDR, banded borders, blank screen shares

hyprlandwaylandomarchyomarchy-4archendeavouroscachyosmanjarodesktoplaptopamdnvidiaintelxdg-desktop-portal
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

The diagnosis and every wiki fact are right: render:cm_auto_hdr default 1, keep_unmodified_copy default 2 with the literal note "Set to 1 if screenshots are transparent.", quirks:prefer_hdr 0/1/2 with 2 = gamescope only, the cm preset block reproduced verbatim, sdrbrightness/sdrsaturation defaults 1.0 and the documented 1.0..2.0 range, the "Colors registered in Hyprland (e.g. the border color) do not support 10 bit" warning, cm_enabled "requires a restart of Hyprland to fully take effect", and the mpv --target-colorspace-hint-mode=source note. xdph #313, Hyprland #9286 and discussion #10950 all exist and say what is claimed. But the config API is fabricated: hl.set("render:keep_unmodified_copy", 1) does not exist. The Variables page documents exactly one syntax, hl.config({ category = { value = ... } }), and there is no hl.set anywhere in the wiki or in the entire Omarchy quattro tree, which uses hl.config({ cursor = { no_hardware_cursors = ... } }) throughout. Copy-pasting those two lines throws a Lua error and the whole config file fails to load, which is worse than the original symptom. The hl.monitor({...}) blocks are fine as written.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.
RISK

cm and bitdepth changes force a modeset. The wiki notes that render:send_content_type (default true) reporting content type to the monitor "may result in a black screen during the switch". On some panels the screen can stay black for several seconds or until you re-plug. Do not set cm = "hdr" on your only monitor without a TTY (Ctrl+Alt+F2) available so you can edit ~/.config/hypr/monitors.lua back and hyprctl reload. hdr/hdredid are marked experimental upstream. An ICC profile plus HDR is explicitly unsupported ("ICCs are fundamentally incompatible with HDR gaming").

Symptom

I turned on HDR with bitdepth = 10 and cm = "hdr" and now everything SDR looks grey and washed out: the desktop, the browser, YouTube in a window. Window borders and gradients look banded. Worse, screen sharing in Discord/Meet/OBS now shows a completely black or blank window, and hyprshot/screenshots come out empty or transparent. Sometimes after a fullscreen HDR game exits, the whole desktop stays washed out until I run hyprctl reload.

Cause

Three separate documented effects get blamed on one setting. (1) cm = "hdr" puts the whole output on a wide-gamut BT.2020 + PQ transfer function, and SDR content mapped into it looks dim and desaturated unless sdrbrightness/sdrsaturation are raised. The Hyprland wiki marks hdr/hdredid as experimental. (2) The wiki warns explicitly that colors registered inside Hyprland (window border colors, gradients) do *not* support 10 bit, so borders band. (3) 10-bit/HDR buffers are not consumable by many capture clients: xdg-desktop-portal-hyprland issue #313 is exactly "screenshare is broken when HDR is enabled", fixed by dropping back to 8 bit. HDR-mode screenshots also come out empty unless render:keep_unmodified_copy is forced on. The lingering washed-out desktop after a fullscreen HDR app exits is hyprwm/Hyprland #9286 / discussion #10950.

Fix

Only the two hl.set(...) lines are wrong. Everything else in the record stands as written. Replace them with the documented hl.config form (Variables page: hl.config({ category = { value = ... } })).

Fix blank/empty screen capture and screenshots. In ~/.config/hypr/looknfeel.lua:


hl.config({ render = { keep_unmodified_copy = 1 } })  -- default 2 (auto); 1 = always keep an SDR copy

Fix apps that need HDR on before they launch (gamescope):


hl.config({ quirks = { prefer_hdr = 2 } })   -- 0 off, 1 always, 2 gamescope only

Both can be merged into one call:


hl.config({
  render = { keep_unmodified_copy = 1 },
  quirks = { prefer_hdr = 2 },
})

To try either without editing a file first, hyprctl eval takes the same Lua:


hyprctl eval 'hl.config({ render = { keep_unmodified_copy = 1 } })'

Then hyprctl reload as the record already says. Also worth adding: #9286 is closed as *completed* and #10950 is its open follow-up discussion, so the stuck-washed-out-after-fullscreen behaviour is version-dependent. Check hyprctl version before assuming you are hitting it.

Verify

hyprctl monitors -j | jq -r '.[] | "\(.name) \(.currentFormat) \(.activelyTearing)"' shows a 10-bit format (e.g. XRGB2101010) once bitdepth = 10 is active. Take a screenshot and confirm it is not transparent/empty, then start a screen share and confirm the preview is not black.

Sources

hdr-10bit-washed-out-and-broken-capture