Keyboard lighting
Control static RGB lighting and keyboard-stored backlight settings on supported Logitech keyboards.
OpenLogi separates static RGB lighting from a keyboard's white backlight. The HID++ features that a keyboard reports decide which controls appear.
| Keyboard capability | HID++ feature | Where to control it | Controls | Storage |
|---|---|---|---|---|
| RGB keyboard | One of 0x8070, 0x8071, 0x8081, or 0x8080 | Lighting tab | One static colour, an on/off switch, and Brightness | config.toml; the agent reapplies the saved setting when the keyboard reconnects |
| White-backlight keyboard | 0x1982 | Device tab → Backlight card | Light the keys, plus the controls the keyboard advertises | Keyboard non-volatile memory; never config.toml |
| Keyboard with only legacy Backlight1 | 0x1981 | No control | Not supported | Not written |
Static RGB lighting
Select an RGB keyboard in the device gallery and open its Lighting tab. The tab appears when OpenLogi detects at least one supported RGB feature.
- Select a colour swatch to enable lighting and apply that static colour.
- Brightness accepts
0–100in steps of5. The slider writes the value when you release it. - OpenLogi provides a whole-keyboard static colour. It does not provide animated effects or a per-key colour editor.
In the config
OpenLogi saves the RGB selection by physical device key. It reloads the agent so the agent can apply that selection again after a reconnect.
[devices."receiver:aabbccdd:slot:1".lighting]
enabled = true
color = "ff0000"
brightness = 80enabled, color, and brightness remain in the config while lighting is
off. Re-enabling lighting restores the saved colour and brightness. See
Configuration for the full reference.
Protocol and diagnostics
OpenLogi tries the RGB paths in this order: 0x8070, 0x8071, 0x8081, then
0x8080. The preferred 0x8070 path selects a volatile fixed-colour effect,
which can replace a running onboard profile.
When OpenLogi uses 0x8071, the agent keeps software control for its session
and returns control to the firmware when it exits. It serializes writes and
release work so an old release cannot replace a later colour selection.
Use the diagnostic command to set a solid colour on a wired RGB keyboard. It uses the same HID++ write path as the GUI.
openlogi diag lighting ff0000Quit Logi Options+ first. Both applications require exclusive HID++ access.
White backlight
An online keyboard that reports 0x1982 shows the Backlight card on its
Device tab. The card reads the keyboard's state and shows only the controls
that the keyboard accepts.

- Light the keys is available on every
0x1982keyboard. The keyboard saves this setting, so it applies on every computer. - Automatic brightness appears when the keyboard supports automatic mode. It adjusts brightness to the light around the keyboard.
- Brightness appears when the keyboard supports software level selection.
The buttons span
0through the highest level the keyboard reports. Choosing a level turns Automatic brightness off. - Battery saving appears when the keyboard supports it. The keyboard turns the backlight off when its battery runs low.
Turning Light the keys off disables Automatic brightness and Brightness, but not Battery saving. When firmware, rather than the setting, turns the keys off, the card says Off while the battery is critically low. or Off while the room is bright enough.
The card writes each accepted change to the keyboard and replaces its displayed
state with the keyboard's read-back. Backlight settings are stored only in the
keyboard's non-volatile memory, not in config.toml.
From the command line
openlogi backlight reads the current state and the controls a selected
keyboard offers. The same persistent 0x1982 controls are available from the
command line:
openlogi backlight auto on
openlogi backlight level 3
openlogi backlight battery-saving onA level must be from 0 through the keyboard's reported level count minus one.
openlogi backlight off keeps the LEDs dark regardless of ambient light or
hand proximity. openlogi backlight on restores the stored mode and level.
The command needs a running OpenLogi agent. It sends each change through the agent, so an open Backlight card shows the new state. See Command line for the device selection rules.
On-screen backlight level
OpenLogi shows a transient on-screen Backlight level indicator when it
receives a backlight-change event. The indicator shows the current and highest
reported levels, then hides after 1,500 ms. See
Notifications for the related on-screen notices.
Status: macOS, Linux, and Windows. See
0x8070 colorLedEffects,
0x8071 rgbEffects,
0x8081 perKeyLighting2,
0x8080 perKeyLighting, and
0x1982 backlight for protocol detail.