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
| Attribute | HID++ controls | OS-hook function keys |
|---|---|---|
| Scope | One Logitech keyboard that reports reprogrammable controls | Keyboard events received by this computer |
| Identity | HID++ 0x1b04 16-bit control ID | esc, f1–f19, with optional modifiers |
| Config | [devices."unit:6be9d300".bindings] | [keyboard.bindings] |
| Scope of a binding | Per physical device; an app profile can override it | Global to the computer |
| GUI | Keys shows marked HID++ controls | Keys falls back to the function row |
| Platforms | macOS, Linux, and Windows | macOS 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.

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 key | Keys label | CID |
|---|---|---|
KeyBrightnessDown | Brightness Down Key | 0x00c7 |
KeyBrightnessUp | Brightness Up Key | 0x00c8 |
KeyBacklightDown | Backlight Down Key | 0x00e2 |
KeyBacklightUp | Backlight Up Key | 0x00e3 |
KeyMissionControl | Mission Control Key | 0x00e0 |
KeyLaunchpad | Launchpad Key | 0x00e1 |
KeyShowDesktop | Show Desktop Key | 0x006e |
KeySearch | Search Key | 0x00d4 |
KeyDictation | Dictation Key | 0x0103 |
KeyEmoji | Emoji Key | 0x0108 |
KeyScreenCapture | Screen Capture Key | 0x010a |
KeyPrintScreen | Print Screen Key | 0x00bf |
KeyMicMute | Mic Mute Key | 0x011c |
KeyPreviousTrack | Previous Track Key | 0x00e4 |
KeyPlayPause | Play/Pause Key | 0x00e5 |
KeyPlayPauseTrack | Play/Pause Key (track) | 0x0141 |
KeyNextTrack | Next Track Key | 0x00e6 |
KeyMute | Mute Key | 0x00e7 |
KeyVolumeDown | Volume Down Key | 0x00e8 |
KeyVolumeUp | Volume Up Key | 0x00e9 |
KeyCalculator | Calculator Key | 0x000a |
KeyLock | Lock Key | 0x006f |
KeyDoNotDisturb | Do Not Disturb Key | 0x011d |
KeyEmojiHeartEyes | Heart-Eyes Emoji Key | 0x0104 |
KeyEmojiCrying | Crying Emoji Key | 0x0105 |
KeyEmojiSmiley | Smiley Emoji Key | 0x0106 |
KeyEmojiTears | Tears-of-Joy Emoji Key | 0x0107 |
KeyLookUp | Look Up Key | 0x00ea |
KeyAppSwitch | App Switch Key | 0x0100 |
KeyAppSwitchLaunchpad | App Switch / Launchpad Key | 0x0109 |
KeyHome | Home Key | 0x0118 |
KeyEnd | End Key | 0x0119 |
KeyPageUp | Page Up Key | 0x011a |
KeyPageDown | Page Down Key | 0x011b |
KeyMultiPlatformAppSwitch | App Switch Key (multiplatform) | 0x00ba |
KeyMultiPlatformHome | Home Key (multiplatform) | 0x00bb |
KeyMultiPlatformMenu | Menu Key (multiplatform) | 0x00bc |
KeyMultiPlatformInsert | Insert Key (multiplatform) | 0x00be |
KeyLanguageSwitch | Language Switch Key | 0x00dd |
KeyCircle | Circle Key | 0x01a3 |
KeyTriangle | Triangle Key | 0x01a4 |
KeyDiamond | Diamond Key | 0x01a5 |
KeyStar | Star Key | 0x01a6 |
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.

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.
Related keyboard features
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.