Reference
Key names, action types, the messages the apps show, and where KeyDeck keeps its data.
Action types
| Action | Field | What happens on a tap |
|---|---|---|
| Hotkey | Modifiers and Key | Presses the key combination in the window in front. |
| Text | Text to type | Types the text into the window in front. |
| Command | Shell command | Runs the command in the background through /bin/sh -c. |
| None | Nothing. |
Hotkey key names
Type these names in the Key box, or pick them from its list.
| Group | Names |
|---|---|
| Letters | a to z |
| Digits | 0 to 9 |
| Function keys | f1 to f12 |
| Editing | enter, esc, tab, space, backspace, delete |
| Navigation | up, down, left, right, home, end, pageup, pagedown |
| Media | volumeup, volumedown, mute, playpause, nextsong, prevsong |
| Punctuation | comma, period, slash, semicolon, quote, minus, equal |
Modifiers: Ctrl, Shift, Alt, Super.
Layout limits
| Setting | Range |
|---|---|
| Rows | 1 to 6 |
| Columns | 1 to 8 |
| Keys per layout | 1 to 48 |
| Phone orientation | Auto, Portrait, Landscape |
Desktop status messages
| Message | Meaning |
|---|---|
| No network — connect to WiFi | The computer has no network address to put in the QR code. |
| WiFi / USB: waiting for phone | No phone is connected over the network yet. |
| Connected: and a device name | A phone is connected over the network. |
| Bluetooth: Off or Bluetooth off | The Bluetooth switch is off. |
| Scanning for phone… | Bluetooth is on and looking for the phone. |
| Connected over Bluetooth | A phone is connected over Bluetooth. |
| Bluetooth is off | Bluetooth is turned off on the computer. |
| Injection backend: and a name | The tool used to press keys: xdotool or ydotool. |
| Key injection unavailable. | No tool to press keys was found. Install xdotool or ydotool. |
Phone status messages
| Message | Meaning |
|---|---|
| Connecting over WiFi… | The phone is reaching the desktop over the network. |
| Advertising to the desktop over Bluetooth… | The phone is waiting for the desktop to find it. Turn on Bluetooth in the desktop app. |
| Bad token | The QR code is from an earlier run of the desktop app. Scan the current one. |
| Connection lost | The link to the desktop dropped. |
| Connection lost (no response from desktop) | The desktop stopped answering. |
| Not connected | The pad is not connected. Tap Back and scan again. |
Network and Bluetooth
| Item | Value |
|---|---|
| Wi-Fi port | 8737, or a random free port if 8737 is busy |
| Wi-Fi protocol | WebSocket on the local network |
| Bluetooth | Bluetooth Low Energy. The phone advertises, the desktop connects. No system pairing. |
| Token | New on every start of the desktop app |
Files
| What | Where |
|---|---|
| Layouts and keys | keydeck.json in the desktop app's application data folder |
| Last scanned QR code | Stored inside the phone app |