OpenLogi

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 capabilityHID++ featureWhere to control itControlsStorage
RGB keyboardOne of 0x8070, 0x8071, 0x8081, or 0x8080Lighting tabOne static colour, an on/off switch, and Brightnessconfig.toml; the agent reapplies the saved setting when the keyboard reconnects
White-backlight keyboard0x1982Device tab → Backlight cardLight the keys, plus the controls the keyboard advertisesKeyboard non-volatile memory; never config.toml
Keyboard with only legacy Backlight10x1981No controlNot supportedNot 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–100 in steps of 5. 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 = 80

enabled, 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 ff0000

Quit 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.

MX Keys S Device tab with the Backlight card

The Backlight card on the Device tab.
  • Light the keys is available on every 0x1982 keyboard. 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 0 through 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 on

A 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.

On this page