Recover a laptop screen stuck black after turning brightness to the bottom
The cause holds. brightnessctl 0.5.1 percent_to_val is roundf(percent/100 * max), so 1% of 15 is raw 0, and omarchy-brightness-display turns +5% at 0% into an absolute 1%. Issue #8523 (open) confirms both reports. Two defects in the fix. First, it tells a user with a black screen to type blind, but the stock bindings in default/hypr/bindings/media.lua already escape: SHIFT + XF86MonBrightnessUp runs omarchy-brightness-display 100%, and ALT + XF86MonBrightnessUp runs +1%, which brightnessctl treats as relative and forces to at least one raw step (calc_value sets mod to 1 when rounding gives 0). Second, the prevention block leaves ALT + XF86MonBrightnessDown bound to omarchy-brightness-display 1%-. From raw 1 of 15 that is relative 5.67%, which rounds to raw 1, so brightnessctl forces -1 and lands on raw 0 again. The corrected fix adds the key escape first and unbinds the Alt variant too. --min-value=1 confirmed as brightnessctl 0.5.1's optional-argument form. Not exercised on a panel with max_brightness 15.
Symptom
I turned the brightness all the way down with Fn+F1 and the screen went completely black. Pressing Fn+F2 (brightness up) does nothing, so I cannot see anything to fix it. Shift+brightness-down does the same thing in one press. Reported on a 2012 13-inch MacBook Pro Retina and an Ivy Bridge HD 4000 laptop, both using acpi_video0 with max_brightness 15.
Cause
Below 5%, omarchy-brightness-display steps one percent at a time. At 0% it computes a 1% target and runs brightnessctl -d acpi_video0 set 1%. With max_brightness 15, 1% is 0.15 of a raw step, which brightnessctl rounds to raw 0, so the brightness stays at 0 on every press and the up key can never climb out. The Shift+XF86MonBrightnessDown binding in default/hypr/bindings/media.lua runs omarchy-brightness-display 1%, which lands on the same raw 0 on these devices. Both are in 4.0.4-1 and on quattro as of 2026-10-04. The issue is open, and a reporter confirmed on 4.0.2-1 that a raw +1 step recovers the panel.
Fix
**Get the picture back with a key.** Press Shift+brightness-up (Shift+Fn+F2 where F2 needs Fn). Omarchy binds it to omarchy-brightness-display 100%, which sets full brightness and does not round to 0. Alt+brightness-up also works: it runs omarchy-brightness-display +1%, and brightnessctl always moves a relative change by at least one raw step.
If neither key is reachable, type this blind into a terminal (Super+Enter opens one), or run it over ssh. The value is a raw step, not a percentage:
brightnessctl -d "$(omarchy-hw-display)" set 5
**Check whether your panel is affected:**
omarchy-hw-display
cat /sys/class/backlight/$(omarchy-hw-display)/max_brightness
A max_brightness under 100 can round a 1% target to 0.
**Prevent it (Omarchy 4).** Replace the brightness-down bindings in ~/.config/hypr/bindings.lua with raw steps that cannot fall below 1. Three default bindings can reach raw 0 on these panels: plain, Shift and Alt brightness-down. Swap acpi_video0 for the name omarchy-hw-display printed:
hl.unbind("XF86MonBrightnessUp")
hl.unbind("XF86MonBrightnessDown")
hl.unbind("SHIFT + XF86MonBrightnessDown")
hl.unbind("ALT + XF86MonBrightnessDown")
o.bind("XF86MonBrightnessUp", "Brightness up", "brightnessctl -d acpi_video0 set +1", { locked = true, repeating = true })
o.bind("XF86MonBrightnessDown", "Brightness down", "brightnessctl -d acpi_video0 --min-value=1 set 1-", { locked = true, repeating = true })
Shift+brightness-up and Alt+brightness-up keep their stock bindings, so the key escape above still works. These bindings skip Omarchy's on-screen brightness indicator.
Verify
Hold brightness-down until it stops, then press Alt+brightness-down a few times. cat /sys/class/backlight/acpi_video0/brightness reads 1, not 0, the panel is still faintly lit, and brightness-up raises it again.