Keyboard lighting

OpenLogi drives two different keyboard lighting systems: the RGB engine on G-series boards, as one static colour rather than per-key effects, and the white, level-adjustable backlight on the MX Keys line. For Litra lights, see Litra lights.

RGB keyboards

Select the keyboard in the device carousel and open its Lighting tab:

• Colour swatches — a small palette of preset accent colours.
• On / off — toggle whether the static colour is applied.
• Brightness — a 0–100 slider. The level is pushed to the keyboard when you release the slider, so dragging doesn't stream a burst of updates.

Under the hood OpenLogi prefers the keyboard's effect engine — HID++ 0x8070 colorLedEffects, writing the fixed single-colour effect — because that replaces a running onboard profile, which a per-key 0x8080 write can't override on G-series firmware. The colour is applied to RAM only, so nothing is burned into flash; the agent re-applies it when the keyboard reconnects.

Your choice is saved per device under [devices.<key>.lighting] in the config (enabled, color, brightness).

MX Keys backlight

Keyboards with the white proximity backlight expose HID++ 0x1982 backlight instead of an RGB engine. It is driven from the CLI:

openlogi backlight            # current state (mode, level, status)
openlogi backlight off        # dark regardless of ambient light or hand proximity
openlogi backlight on         # restore the keyboard's stored mode and level

Unlike the RGB path, this writes the keyboard's non-volatile configuration, so it survives reconnects, host switches, and power cycles with nothing re-applying it.

Status: macOS, Linux, and Windows. Protocol detail is on 0x8070 colorLedEffects, 0x8081 perKeyLighting2, and 0x1982 backlight.