Fix brightness keys that move the OSD but never change the laptop screen
bin/omarchy-hw-display on 4.0.4-1 picks gmux_backlight, amdgpu_bl*, intel_backlight, acpi_video*, else the first listed device after excluding appletb_backlight, as the cause says. The Arch wiki Backlight page (raw wikitext) supports the 6.1 rework note, acpi_backlight=nvidia_wmi_ec for some Optimus laptops, the NVIDIA-only MUX case where nvidia_wmi_ec_backlight accepts values but does nothing and acpi_backlight=native fixes it, the exact nvidia-modeset log line, the vendor-makes-it-disappear note, and the Razer Blade 14 / Yoga Slim 7 / IdeaPad Gaming 3 / Acer AN517-41 list with acpi_backlight=video and amdgpu.backlight=0. The wiki says to remove an old acpi_backlight parameter first, which the record paraphrases as counterproductive, a fair reading. The Omarchy 4 branch matches this machine: /etc/limine-entry-tool.d/ holds omarchy-defaults.conf (with initramfs_async=0 and the Plymouth comment) and omarchy-uki.conf, so zz-local.conf sorts last. limine-update exists and itself calls limine-install and limine-mkinitcpio, so the && chain rebuilds twice, redundant but harmless. Confidence is medium because the Limine-editor recovery in danger was not exercised and no parameter was applied here.
A wrong kernel parameter can leave you with no backlight control, or a black panel until it is removed. Per the Arch wiki, acpi_backlight=vendor can make the interface disappear entirely on NVIDIA-only laptops. On Omarchy 4, writing KERNEL_CMDLINE[default]= without the +, or using a bare tee instead of tee -a, wipes Omarchy's own parameters, including initramfs_async=0, which keeps the Plymouth LUKS prompt working. limine-mkinitcpio rewrites the UKI on the ESP, so run df -h /boot first. To recover, remove the parameter in the Limine boot menu editor, or boot a Limine snapshot entry.
Symptom
The brightness keys show the OSD going up and down, but the screen never gets brighter or dimmer. ls /sys/class/backlight lists two devices, for example intel_backlight and nvidia_wmi_ec_backlight, or acpi_video0 and amdgpu_bl1, and writing to the one in use does nothing. Common on Optimus and MUX laptops and on some Razer, Lenovo and Acer models. The kernel log may show nvidia-modeset: ACPI reported no NVIDIA native backlight available; attempting to use ACPI backlight.
Cause
The kernel can register more than one backlight interface for the same panel, and only one of them actually drives it. Since Linux 6.1 the kernel picks which types register from ACPI heuristics, and acpi_backlight= overrides that choice. On Omarchy, omarchy-hw-display picks the device in a fixed order: gmux_backlight, then amdgpu_bl*, then intel_backlight, then acpi_video*, then the first device listed. If the working interface is a different one, for example nvidia_wmi_ec_backlight on a hybrid laptop, or the earlier entry in the order is the dead one, every key press goes to an interface that the panel ignores.
Fix
**Find the interface that works.** Try each device listed and watch the screen:
ls /sys/class/backlight/
omarchy-hw-display # the one Omarchy's keys use
brightnessctl -d intel_backlight set 30%
brightnessctl -d nvidia_wmi_ec_backlight set 30%
**Quick fix with no reboot:** rebind the keys in ~/.config/hypr/bindings.lua to the device that worked:
hl.unbind("XF86MonBrightnessUp")
hl.unbind("XF86MonBrightnessDown")
o.bind("XF86MonBrightnessUp", "Brightness up", "brightnessctl -d nvidia_wmi_ec_backlight set +5%", { locked = true, repeating = true })
o.bind("XF86MonBrightnessDown", "Brightness down", "brightnessctl -d nvidia_wmi_ec_backlight set 5%-", { locked = true, repeating = true })
**Proper fix: make the kernel register the right type.** Pick the parameter from what worked, using the Arch wiki's guidance:
acpi_backlight=native: the GPU's own interface works (intel_backlight,amdgpu_bl*). The wiki also gives it for NVIDIA-only MUX laptops wherenvidia_wmi_ec_backlightregisters but does nothing.acpi_backlight=nvidia_wmi_ec: some Optimus laptops.acpi_backlight=video, withamdgpu.backlight=0on AMD if needed: Razer Blade 14, Lenovo Yoga Slim 7, Lenovo IdeaPad Gaming 3, Acer AN517-41.
If you already pass an acpi_backlight= parameter, remove it first. The wiki says the 6.1 rework made old values counterproductive.
**Omarchy 4** builds the kernel command line into the UKI. Add a drop-in that sorts after omarchy-defaults.conf, and always use +=:
sudo tee -a /etc/limine-entry-tool.d/zz-local.conf >/dev/null <<'EOF'
KERNEL_CMDLINE[default]+=" acpi_backlight=native"
EOF
sudo limine-mkinitcpio && sudo limine-update && sudo reboot
**Plain Arch:** add it to GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub and run sudo grub-mkconfig -o /boot/grub/grub.cfg, or append it to options in /boot/loader/entries/*.conf for systemd-boot. Then reboot.
Verify
cat /proc/cmdline contains the new parameter, ls /sys/class/backlight shows the working device (alone, or first in omarchy-hw-display's order), and the brightness keys change the panel.