← Back to Midnight Keyboard

Why Apple Won't Let You Dim Your Keyboard

By Midnight Keyboard Dev · March 24, 2026

If you've ever used your MacBook in a dark room, late at night, on a red-eye flight, or next to someone sleeping, you've probably noticed that the keyboard backlight's lowest setting is still annoyingly bright.

Some MacBook models are worse than others. Certain M-series machines have an inexplicably bright minimum brightness level that's borderline unusable in a dark room, especially when you've got your display dimmed for comfortable nighttime use.

You drag the brightness slider all the way down. Still glowing. You tap F5 until it bottoms out. Still too bright. Your only option is to turn the backlight off entirely, and then you can't see the keys at all.

There's a gap between "too bright" and "off" that Apple won't let you access. This article explains why, and how we built Midnight Keyboard to fix it.

The hardware can go dimmer. Apple just won't let it.

Your MacBook's keyboard backlight is controlled by a PWM (pulse-width modulation) controller. The LEDs don't actually dim. They flicker on and off thousands of times per second, and the ratio of on-time to off-time determines how bright the backlight appears to your eyes.

On Apple Silicon Macs, the keyboard backlight controller has dozens of discrete brightness steps between fully off and the macOS minimum. The hardware supports all of them. But macOS clamps the keyboard brightness to a floor value, and anything below that floor gets rounded up to the minimum or snapped to off.

Off <---- hidden PWM steps ----> macOS min <-- macOS range --> Max ↑ Apple's hard floor. You can't go below this.

The hardware is capable of much dimmer brightness than Apple exposes. The limit is entirely in software.

Why does Apple lock it?

Apple doesn't publish a reason, but the likely explanation is simple: PWM flicker.

At very low duty cycles, the on-off flickering of the LEDs can become perceptible. Some people are sensitive to PWM flicker, and Apple likely chose a minimum that sits safely above the threshold where most users would notice it. A conservative design choice: better to be slightly too bright than to cause discomfort.

There may also be a practical consideration. At the lowest PWM steps, the brightness difference between adjacent levels is negligible. From Apple's perspective, exposing dozens of extra slider positions probably isn't worth it when most of them look identical to most people.

But if you're working in a truly dark environment, those lower steps matter. A lot.

What's happening under the hood

macOS controls the keyboard backlight through a private system framework. When you move the brightness slider or press F5/F6, it sets a target brightness and drives the hardware through a smooth transition to that target.

The key observation: sub-minimum brightness levels are briefly visible during these transitions. When macOS is actively fading the backlight between the minimum and off, the hardware passes through all the intermediate PWM steps. For a moment, the backlight sits at a brightness level that macOS would never let you set directly.

The problem is that transitions complete quickly. The backlight arrives at its target (off or minimum) and stays there. You can't ask the system to set brightness to a sub-minimum value directly. It clamps it.

How Midnight Keyboard works

We found a way to catch the hardware during those transitions and hold it at the brightness level we want.

The general idea: start a transition, watch the hardware's brightness in real time, and the moment it reaches the desired sub-minimum level, begin a hold sequence that prevents it from drifting further. The hold sequence uses carefully calibrated timing to counteract the hardware's natural tendency to complete the fade.

Getting this to work reliably took months of research and calibration. The timing has to be precise enough that the brightness stays locked to a single PWM step without visible flickering. Different brightness levels need different hold parameters, and the system has to adapt on the fly to varying conditions.

We're deliberately keeping the implementation details light here. If you're curious about the general approach, the short version is: it's a real-time feedback control system fighting against a framework that was never designed to be controlled this way.

The result

Midnight Keyboard gives you 10 usable sub-minimum brightness levels, ranging from barely visible (roughly 20x dimmer than Apple's minimum) to a comfortable glow that's still well below the macOS floor. The lowest levels are ideal for a dark room where you want to see the key legends without them lighting up the whole space.

It's a small thing. But if you've ever been bothered by a keyboard that's too bright at night, it makes a real difference.

Free 3-night trial, no account required.

Download Midnight Keyboard

$7 one-time to unlock after trial. macOS 14+, Apple Silicon only.