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 gallery 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. If that feature is absent, it tries 0x8071 rgbEffects, then 0x8081 perKeyLighting2, then 0x8080 perKeyLighting. These are alternative paths to the same static colour control, not an editor for animated effects or individual keys. The colour is applied to RAM only, so nothing is burned into flash; the agent re-applies it on reconnect.

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, 0x8071 rgbEffects, 0x8081 perKeyLighting2, and 0x1982 backlight.