OpenLogi

Keyboards

Bind Logitech keyboard controls over HID++, remap function keys through the OS hook, and manage keyboard-specific settings.

OpenLogi has two independent keyboard binding paths. Select a keyboard and open its Keys tab to use the path available for that device.

Two keyboard binding paths

AttributeHID++ controlsOS-hook function keys
ScopeOne Logitech keyboard that reports reprogrammable controlsKeyboard events received by this computer
IdentityHID++ 0x1b04 16-bit control IDesc, f1–f19, with optional modifiers
Config[devices."unit:6be9d300".bindings][keyboard.bindings]
Scope of a bindingPer physical device; an app profile can override itGlobal to the computer
GUIKeys shows marked HID++ controlsKeys falls back to the function row
PlatformsmacOS, Linux, and WindowsmacOS and Windows; Linux does not capture keyboard events

Bind a key in the GUI

Click a key on the Keys tab to open its panel. The panel lists the same action catalog as the mouse button picker, plus a Power User section. Pick an action to bind it.

MX Keys S Keys tab listing each key's binding

Keys tab on an MX Keys S.

To clear a binding, choose Native function, or pick the action that is already bound again. Both remove the override, so the key returns to its native behavior. The F-key panel in v0.8.15 has no Reset to defaults button.

HID++ keyboard controls

A Logitech keyboard that exposes HID++ 0x1b04 reprogrammable controls binds keys by their 16-bit control ID (CID). When the keyboard image has control markers, the Keys tab shows those controls. Otherwise, it shows the OS-hook function row.

Use a catalog name below or control:0x<cid> for any divertable control from openlogi diag controls. An unbound control keeps its firmware action. A stored None is not unbound in v0.8.15: the agent diverts and suppresses that control. Delete the control entry to restore its firmware action.

[devices."unit:6be9d300".bindings]
KeySearch = "MissionControl"
KeyCalculator = { CustomShortcut = "Cmd+Shift+C" }
"control:0x01f3" = "ShowActionsRing"

Control catalog

OpenLogi names these 43 HID++ controls. The Keys tab uses the localized labels when the keyboard reports the matching control.

Config keyKeys labelCID
KeyBrightnessDownBrightness Down Key0x00c7
KeyBrightnessUpBrightness Up Key0x00c8
KeyBacklightDownBacklight Down Key0x00e2
KeyBacklightUpBacklight Up Key0x00e3
KeyMissionControlMission Control Key0x00e0
KeyLaunchpadLaunchpad Key0x00e1
KeyShowDesktopShow Desktop Key0x006e
KeySearchSearch Key0x00d4
KeyDictationDictation Key0x0103
KeyEmojiEmoji Key0x0108
KeyScreenCaptureScreen Capture Key0x010a
KeyPrintScreenPrint Screen Key0x00bf
KeyMicMuteMic Mute Key0x011c
KeyPreviousTrackPrevious Track Key0x00e4
KeyPlayPausePlay/Pause Key0x00e5
KeyPlayPauseTrackPlay/Pause Key (track)0x0141
KeyNextTrackNext Track Key0x00e6
KeyMuteMute Key0x00e7
KeyVolumeDownVolume Down Key0x00e8
KeyVolumeUpVolume Up Key0x00e9
KeyCalculatorCalculator Key0x000a
KeyLockLock Key0x006f
KeyDoNotDisturbDo Not Disturb Key0x011d
KeyEmojiHeartEyesHeart-Eyes Emoji Key0x0104
KeyEmojiCryingCrying Emoji Key0x0105
KeyEmojiSmileySmiley Emoji Key0x0106
KeyEmojiTearsTears-of-Joy Emoji Key0x0107
KeyLookUpLook Up Key0x00ea
KeyAppSwitchApp Switch Key0x0100
KeyAppSwitchLaunchpadApp Switch / Launchpad Key0x0109
KeyHomeHome Key0x0118
KeyEndEnd Key0x0119
KeyPageUpPage Up Key0x011a
KeyPageDownPage Down Key0x011b
KeyMultiPlatformAppSwitchApp Switch Key (multiplatform)0x00ba
KeyMultiPlatformHomeHome Key (multiplatform)0x00bb
KeyMultiPlatformMenuMenu Key (multiplatform)0x00bc
KeyMultiPlatformInsertInsert Key (multiplatform)0x00be
KeyLanguageSwitchLanguage Switch Key0x00dd
KeyCircleCircle Key0x01a3
KeyTriangleTriangle Key0x01a4
KeyDiamondDiamond Key0x01a5
KeyStarStar Key0x01a6

Global function-key remapper

The OS-hook path remaps esc and f1–f19 from any keyboard. Its bindings are global, so they do not belong to a Logitech device or an app profile. Use [modifier+]key; valid modifiers are shift, control (ctrl), option (alt), and command (cmd).

Fn is not a valid trigger because the firmware does not report it as an ordinary key modifier. Choose Native function in the Keys panel to clear a function-key binding. The GUI removes that trigger from [keyboard.bindings].

[keyboard.bindings]
f1 = "MissionControl"
"shift+f2" = "ShowDesktop"
"cmd+f5" = { CustomShortcut = "Cmd+Shift+P" }

The action list includes Actions Ring. Its Power User section edits Type Text… and Workflow… actions. The configuration format also supports CustomShortcut for an immediate key combination; see the full configuration reference.

Device settings

Select a keyboard and open its Device tab. The keyboard card contains the settings that the connected keyboard supports.

MX Keys S Device tab with Keys and Backlight cards

Keyboard settings on the Device tab.

Fn Lock makes bare F-row keys send F1–F12. The printed function then moves to Fn + key. OpenLogi supports HID++ 0x40a3, 0x40a2, and 0x40a0 Fn-inversion features, and re-applies a saved setting when the keyboard reconnects.

Keep OS layout applies to multi-platform keyboards that expose HID++ 0x4531. When enabled, the agent sets the keyboard layout for this computer's operating system when the keyboard connects. It sets the layout again after a keyboard layout shortcut changes it.

Easy-Switch. Easy-Switch channels hold paired computers and can coordinate host switching with other devices. See Easy-Switch.

Keyboard lighting. Backlight controls and static RGB lighting are separate from key bindings. See Keyboard lighting.

Lock-key indicators. OpenLogi can show Caps Lock, Num Lock, and Scroll Lock state changes on screen when the keyboard reports them. See on-screen notices.

Status: HID++ control bindings work on macOS, Linux, and Windows when the keyboard reports 0x1b04 specialKeysMSEButtons. Fn Lock uses 0x40a0 fnInversion, 0x40a2 fnInversionWithDefaultState, or 0x40a3 fnInversionMultiHost. Keep OS layout uses 0x4531 multiPlatform. The global function-key remapper works on macOS and Windows. Linux does not capture keyboard events.

On this page