Add missing keyboard keys: navigation, arrows, numpad, and common aliases

Author: AntonW

README.md

@@ -853,7 +853,7 @@ Connect to `ws://<host>:<port>/ws` (or `wss://` behind a reverse proxy).
 | `simulate-button` | `{ "js": 0, "id": 0, "state": 1 }` | Press/release button |
 | `simulate-slider` | `{ "js": 0, "id": 0, "value": 128 }` | Set slider value (0 to `max_value`, default 255) |
 | `simulate-joystick` | `{ "js": 0, "id": 0, "value": { "x": 127, "y": 127 } }` | Set joystick X/Y (0-255) |
-| `simulate-keyboard` | `{ "keyboard_index": 0, "key": "ctrl+a", "state": 1 }` | Press/release key or combo |
+| `simulate-keyboard` | `{ "keyboard_index": 0, "key": "ctrl+a", "state": 1 }` | Press/release key or combo. Key names: letters (`a`–`z`), digits (`0`–`9`), `f1`–`f12`, modifiers (`ctrl`/`shift`/`alt`/`meta`/`win`/`super`), navigation (`insert`/`ins`, `delete`/`del`, `home`, `end`, `pageup`/`pgup`, `pagedown`/`pgdn`), arrows (`up`, `down`, `left`, `right`), numpad (`numpad0`–`numpad9`, `numpadenter`, `numpadplus`, `numpadminus`, `numpadmultiply`, `numpaddivide`), special (`escape`/`esc`, `enter`/`return`, `space`, `tab`, `backspace`, `capslock`, `printscreen`) |
 | `push-data` | `{ "key": "...", "value": ..., "unit": "...", "source": "..." }` | Push data to Data Bus for broadcast |
 | `execute-command` | `{ "block_id": "...", "command_type": "shell", "command": "...", "http_method": "GET", "http_url": "...", "http_body": "...", "params": {...} }` | Execute command with parameters |
 | `start-recording` | `{ "mode": "push-to-talk" }` | Client begins audio recording |

docs/user-manual/de/12-virtual-joysticks.md

@@ -178,9 +178,14 @@ Nutze diese Namen in der Keyboard Key-Einstellung:
 | Buchstaben | `a` bis `z` |
 | Zahlen | `0` bis `9` |
 | Funktionstasten | `f1` bis `f12` |
-| Modifikatoren | `ctrl`, `shift`, `alt`, `meta` |
-| Sondertasten | `space`, `enter`, `escape`, `esc`, `tab`, `backspace`, `capslock` |
+| Modifikatoren | `ctrl`, `shift`, `alt`, `meta`, `win`, `super` |
+| Sondertasten | `space`, `enter`, `return`, `escape`, `esc`, `tab`, `backspace`, `capslock` |
 | Satzzeichen | `minus`, `equal`, `comma`, `dot`, `slash`, `semicolon`, `apostrophe`, `grave`, `backslash`, `leftbracket`, `rightbracket` |
+| Navigation | `insert` / `ins`, `delete` / `del`, `home`, `end`, `pageup` / `pgup`, `pagedown` / `pgdn` |
+| Pfeiltasten | `up`, `down`, `left`, `right` |
+| Numpad | `numpad0`–`numpad9`, `numpaddot`, `numpadenter`, `numpadplus`, `numpadminus`, `numpadmultiply`, `numpaddivide` |
+| Medien | `volumeup`, `volumedown`, `mute`, `playpause`, `stop`, `nextsong`, `previoussong` |
+| System | `printscreen`, `scrolllock`, `numlock` |
 
 Kombiniere Modifikatoren mit `+`: `ctrl+a`, `ctrl+shift+a`, `alt+f4`, `meta+e`.
 

docs/user-manual/en/12-virtual-joysticks.md

@@ -178,9 +178,14 @@ Use these names in the Keyboard Key setting:
 | Letters | `a` through `z` |
 | Numbers | `0` through `9` |
 | Function keys | `f1` through `f12` |
-| Modifiers | `ctrl`, `shift`, `alt`, `meta` |
-| Special keys | `space`, `enter`, `escape`, `esc`, `tab`, `backspace`, `capslock` |
+| Modifiers | `ctrl`, `shift`, `alt`, `meta`, `win`, `super` |
+| Special keys | `space`, `enter`, `return`, `escape`, `esc`, `tab`, `backspace`, `capslock` |
 | Punctuation | `minus`, `equal`, `comma`, `dot`, `slash`, `semicolon`, `apostrophe`, `grave`, `backslash`, `leftbracket`, `rightbracket` |
+| Navigation | `insert` / `ins`, `delete` / `del`, `home`, `end`, `pageup` / `pgup`, `pagedown` / `pgdn` |
+| Arrow keys | `up`, `down`, `left`, `right` |
+| Numpad | `numpad0`–`numpad9`, `numpaddot`, `numpadenter`, `numpadplus`, `numpadminus`, `numpadmultiply`, `numpaddivide` |
+| Media | `volumeup`, `volumedown`, `mute`, `playpause`, `stop`, `nextsong`, `previoussong` |
+| System | `printscreen`, `scrolllock`, `numlock` |
 
 Combine modifiers with `+`: `ctrl+a`, `ctrl+shift+a`, `alt+f4`, `meta+e`.
 

internal/devices/keyboard_linux.go

@@ -108,6 +108,38 @@ const (
 	KEY_BRIGHTNESSUP   = 225
 	KEY_PRINT          = 99
 	KEY_SYSRQ          = 183
+
+	// Navigation cluster
+	KEY_INSERT   = 110
+	KEY_DELETE   = 111
+	KEY_HOME     = 102
+	KEY_END      = 107
+	KEY_PAGEUP   = 104
+	KEY_PAGEDOWN = 109
+
+	// Arrow keys
+	KEY_UP    = 103
+	KEY_DOWN  = 108
+	KEY_LEFT  = 105
+	KEY_RIGHT = 106
+
+	// Numpad
+	KEY_KP0      = 82
+	KEY_KP1      = 79
+	KEY_KP2      = 80
+	KEY_KP3      = 81
+	KEY_KP4      = 75
+	KEY_KP5      = 76
+	KEY_KP6      = 77
+	KEY_KP7      = 71
+	KEY_KP8      = 72
+	KEY_KP9      = 73
+	KEY_KPDOT    = 83
+	KEY_KPENTER  = 96
+	KEY_KPPLUS   = 78
+	KEY_KPMINUS  = 74
+	KEY_KPSLASH  = 98
+	// KEY_KPASTERISK = 55 (already defined above)
 )
 
 // KeyNameToCode maps human-readable key names to Linux input codes.
@@ -148,6 +180,26 @@ var KeyNameToCode = map[string]int{
 	"brightnessup": KEY_BRIGHTNESSUP, "brightnessdown": KEY_BRIGHTNESSDOWN,
 	"printscreen": KEY_PRINT, "sysrq": KEY_SYSRQ,
 	"screenshot": KEY_PRINT,
+	// Navigation cluster
+	"insert": KEY_INSERT, "ins": KEY_INSERT,
+	"delete": KEY_DELETE, "del": KEY_DELETE,
+	"home": KEY_HOME, "end": KEY_END,
+	"pageup": KEY_PAGEUP, "pgup": KEY_PAGEUP,
+	"pagedown": KEY_PAGEDOWN, "pgdn": KEY_PAGEDOWN, "pgdown": KEY_PAGEDOWN,
+	// Arrow keys
+	"up": KEY_UP, "down": KEY_DOWN, "left": KEY_LEFT, "right": KEY_RIGHT,
+	// Numpad
+	"numpad0": KEY_KP0, "numpad1": KEY_KP1, "numpad2": KEY_KP2,
+	"numpad3": KEY_KP3, "numpad4": KEY_KP4, "numpad5": KEY_KP5,
+	"numpad6": KEY_KP6, "numpad7": KEY_KP7, "numpad8": KEY_KP8,
+	"numpad9": KEY_KP9,
+	"numpaddot": KEY_KPDOT, "numpadenter": KEY_KPENTER,
+	"numpadplus": KEY_KPPLUS, "numpadminus": KEY_KPMINUS,
+	"numpadmultiply": KEY_KPASTERISK, "numpaddivide": KEY_KPSLASH,
+	// Common aliases
+	"return": KEY_ENTER,
+	"win": KEY_LEFTMETA, "super": KEY_LEFTMETA,
+	"windows": KEY_LEFTMETA,
 }
 
 // allKeys contains all key codes to register with uinput.
@@ -171,6 +223,14 @@ var allKeys = []uint16{
 	KEY_PLAYPAUSE, KEY_STOPCD, KEY_PREVIOUSSONG, KEY_NEXTSONG,
 	KEY_BRIGHTNESSUP, KEY_BRIGHTNESSDOWN,
 	KEY_PRINT, KEY_SYSRQ,
+	// Navigation cluster
+	KEY_INSERT, KEY_DELETE, KEY_HOME, KEY_END, KEY_PAGEUP, KEY_PAGEDOWN,
+	// Arrow keys
+	KEY_UP, KEY_DOWN, KEY_LEFT, KEY_RIGHT,
+	// Numpad
+	KEY_KP0, KEY_KP1, KEY_KP2, KEY_KP3, KEY_KP4, KEY_KP5,
+	KEY_KP6, KEY_KP7, KEY_KP8, KEY_KP9,
+	KEY_KPDOT, KEY_KPENTER, KEY_KPPLUS, KEY_KPMINUS, KEY_KPASTERISK, KEY_KPSLASH,
 }
 
 // linuxKeyboard represents a virtual keyboard device created via uinput.

internal/devices/keyboard_windows.go

@@ -100,6 +100,37 @@ const (
 	VK_LAUNCH_APP1         = 0xB6
 	VK_LAUNCH_APP2         = 0xB7
 	VK_LAUNCH_MEDIA_SELECT = 0xB5
+
+	// Navigation cluster
+	VK_INSERT   = 0x2D
+	VK_DELETE   = 0x2E
+	VK_HOME     = 0x24
+	VK_END      = 0x23
+	VK_PRIOR    = 0x21 // Page Up
+	VK_NEXT     = 0x22 // Page Down
+
+	// Arrow keys
+	VK_UP    = 0x26
+	VK_DOWN  = 0x28
+	VK_LEFT  = 0x25
+	VK_RIGHT = 0x27
+
+	// Numpad
+	VK_NUMPAD0  = 0x60
+	VK_NUMPAD1  = 0x61
+	VK_NUMPAD2  = 0x62
+	VK_NUMPAD3  = 0x63
+	VK_NUMPAD4  = 0x64
+	VK_NUMPAD5  = 0x65
+	VK_NUMPAD6  = 0x66
+	VK_NUMPAD7  = 0x67
+	VK_NUMPAD8  = 0x68
+	VK_NUMPAD9  = 0x69
+	VK_DECIMAL  = 0x6E
+	VK_ADD      = 0x6B
+	VK_SUBTRACT = 0x6D
+	VK_MULTIPLY = 0x6A
+	VK_DIVIDE   = 0x6F
 )
 
 // KeyNameToCode maps human-readable key names to Windows virtual key codes.
@@ -136,6 +167,26 @@ var KeyNameToCode = map[string]int{
 	"printscreen": VK_SNAPSHOT, "screenshot": VK_SNAPSHOT,
 	"launchapp1": VK_LAUNCH_APP1, "launchapp2": VK_LAUNCH_APP2,
 	"launchmedia": VK_LAUNCH_MEDIA_SELECT,
+	// Navigation cluster
+	"insert": VK_INSERT, "ins": VK_INSERT,
+	"delete": VK_DELETE, "del": VK_DELETE,
+	"home": VK_HOME, "end": VK_END,
+	"pageup": VK_PRIOR, "pgup": VK_PRIOR,
+	"pagedown": VK_NEXT, "pgdn": VK_NEXT, "pgdown": VK_NEXT,
+	// Arrow keys
+	"up": VK_UP, "down": VK_DOWN, "left": VK_LEFT, "right": VK_RIGHT,
+	// Numpad
+	"numpad0": VK_NUMPAD0, "numpad1": VK_NUMPAD1, "numpad2": VK_NUMPAD2,
+	"numpad3": VK_NUMPAD3, "numpad4": VK_NUMPAD4, "numpad5": VK_NUMPAD5,
+	"numpad6": VK_NUMPAD6, "numpad7": VK_NUMPAD7, "numpad8": VK_NUMPAD8,
+	"numpad9": VK_NUMPAD9,
+	"numpaddot": VK_DECIMAL, "numpadenter": VK_RETURN,
+	"numpadplus": VK_ADD, "numpadminus": VK_SUBTRACT,
+	"numpadmultiply": VK_MULTIPLY, "numpaddivide": VK_DIVIDE,
+	// Common aliases
+	"return":  VK_RETURN,
+	"win":     VK_LWIN, "super": VK_LWIN,
+	"windows": VK_LWIN,
 }
 
 // windowsKeyboard represents a virtual keyboard using Windows SendInput API.