HDR / 10-bit enabled: washed-out SDR, banded borders, blank screen shares
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.
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
- https://raw.githubusercontent.com/hyprwm/hyprland-wiki/main/content/Configuring/Basics/Monitors.md
- https://raw.githubusercontent.com/hyprwm/hyprland-wiki/main/content/Configuring/Basics/Variables.md
- https://github.com/hyprwm/xdg-desktop-portal-hyprland/issues/313
- https://github.com/hyprwm/Hyprland/discussions/10950
- https://wiki.hypr.land/Configuring/Basics/Monitors/