Virtual Keyboard · Keyboard, layouts and remotes
The keyboard page is not one fixed on-screen keyboard. It includes seven built-in layouts, an AI remote and a slide remote mode, and layouts can be customised as JSON.
The seven keyboard layouts
Switch layouts from the mode menu at the top of the keyboard page. Each category remembers the layout you used last.
MacBook Pro
A 14/16-inch MacBook Pro (M5) US layout: Esc, F1–F12, power, Delete at the end of the number row, a short Tab row, a wide Return, a right Shift as wide as the left, and half-height ↑↓ between the arrow keys. It is for people who want to touch-type with the MacBook feel. The fn key at the lower left switches to the function layer.
iPhone
A 10×4 layout modelled on the iPhone 8 Plus keyboard: lowercase QWERTY, the a-row inset by half a key on each side, Shift and backspace at the ends of the z-row, 123 / ABC / #+= layers, a globe key, dictation and a wide space bar. It suits one-handed typing and anyone who prefers the iPhone feel.
Numpad
A 4×5 numeric keypad with NumLock, the four operations, backspace and a two-row Enter. It is aimed at finance and heavy number entry.
Function Row
A 6×3 row of F1–F12 plus media keys, useful for presentations and media control.
Function Row Ext
A 5×4 block of F1–F20. F13–F20 use standard HID usages; F21–F24 have no standard macOS virtual key code and are not provided.
Minimal
An 8×2 layout with only modifiers, arrows, Return and backspace. It pairs well with the mixed trackpad page by leaving the upper area for pointer input.
AI Compact
A 12×5 layout: an AI function row at the top (Esc, Tab, clipboard, dictation, Select All, Copy, Paste, ?123, backspace), a QWERTY main block, and a standard modifier and arrow row at the bottom. ?123 opens numbers, brackets, quotes and common symbols; ABC returns. Long-press Return to send or insert a newline. It is built for chat apps and IDEs.
AI remote
The AI remote is a canvas layout in the Remote category. A circular direction wheel in the middle has four ring directions and a central Enter, with Esc, Tab and Space above it, plus backspace, a TALK dictation key and a punctuation row. The wheel is designed for quickly moving through and confirming in conversational AI, presentation and media apps.
Slide remote
Open the mode menu at the top of the AI remote and choose Slide Remote. It shares the same top bar and shows:
- The current page number (relative, reset to 1 when a show starts, ±1 with previous/next, never below 1).
- A session timer that can pause and resume and resets when a show starts.
- Two large keys: Previous and Next.
- Start Show / End Show, plus an Office / Keynote profile.
Key mappings: Previous ←, Next →, End Esc; Office starts with F5, Keynote with ⌘⌥P. It does not read slide content, so it does not show a total page count and does not request Screen Recording or Automation permission.
Key behaviour
- Normal keys send on press and give a light haptic.
- Long-press alternate keys send the primary key on a tap; hold for about 0.45 seconds to send the alternate, such as
⇧⏎. - Modifiers default to Hold mode: ⇧ / ⌘ / ⌥ / ⌃ apply while held and release when lifted, with multi-touch chords. Sticky releases after the next key; Lock stays until tapped again.
- Double-tap Shift locks caps within 0.35 seconds in Sticky or Lock mode.
- Repeat keys such as backspace and the arrows start repeating when held and stop haptics during the repeat.
- Hit-area expansion adds 0–6pt around each key's hit rectangle without changing its appearance.
- Chord and text keys send several usages and modifiers at once (⌘C), or UTF-8 text for punctuation and emoji.
- Media keys such as volume, playback and brightness use separate media messages.
Clipboard
The clipboard key on the AI Compact row pushes the phone clipboard to the Mac. It is one-way, phone → Mac:
- Priority is image, then a single file, then text; only the first available item is sent.
- Text longer than 60,000 bytes is truncated.
- Images and files are split into 1,000-byte chunks with a 512 KB limit per item; larger content is not sent and shows a warning.
- The Mac writes images to the system clipboard. Files are written to
VKClipboard/<filename>in a temporary directory and the file URL is put on the clipboard. - Success shows “Synced to the Mac clipboard”. Empty clipboard, oversized content and no connection all have explicit messages.
On iOS 16 and later the first clipboard read triggers the system Paste permission prompt; that is platform behavior. Clipboard sync can be turned off in Settings, after which the key only shows a hint and reads nothing.
Dictation
The dictation key triggers macOS Dictation: the Mac app simulates a double press of Fn. Success shows “Dictation triggered on Mac”.
Keep the default shortcut under System Settings → Keyboard → Dictation. If it has been changed, the simulated Fn press will not work. Some apps ignore synthetic Fn and do nothing. Universal Bluetooth does not support dictation.
Layout editor
Open Settings → Keyboard Layout → Layout Editor. It offers two views over the same layout data:
- Keys: a live preview above, with a key selected by tapping it. Below, add or remove rows, add, move, copy or delete keys, and edit the label, shift character, usage, text, width, height, long-press text, key colour and repeat flag.
- JSON: edit the layout JSON directly. Parsing starts 0.35 seconds after you stop typing and refreshes the preview; on a parse error the last valid preview stays and the error is shown.
Load built-in or custom layouts and import or export JSON files. Saving validates that the id is non-empty and does not collide with a built-in layout; starting from a built-in layout requires Save as New. Custom layouts appear after all built-in layouts.
Keyboard settings
The gear at the top right of the keyboard page opens a settings sheet. Every change applies and persists immediately:
- Touch feedback: key sound and volume (60% default), haptics on/off and strength (12 default, shared with the trackpad), enlarged key preview, and the not-connected hint.
- Text: size 80%–130%, follow system text size, weight (regular / medium / semibold), and text colour (theme / high contrast / soft grey / warm gold / teal).
- Keycaps: accent colour (blue / green / orange / pink / purple / graphite), corner radius, contrast, key hints, and OLED power-saving display.
- Size: keyboard height (compact / standard / roomy) and key spacing (compact / standard).
- Behaviour: modifier mode (hold / sticky / lock), repeat speed (slow / standard / fast), and hit-area expansion (0–6pt).
Secure Input and Caps Lock
When macOS has Secure Input enabled, the system discards all synthetic keys. The keyboard page shows a small lock in the top bar and, when you actually send a key, a message: “Secure Input is on — keys are blocked (password field or Terminal Secure Keyboard Entry)”.
Secure Input is a system-wide flag: a password field, sudo, an authorisation panel, or even a password manager that still has focus can trigger it. To type into a password field, use the Mac's own keyboard or switch to Universal Bluetooth, which is not affected.
The keyboard page also shows a CAPS badge when macOS Caps Lock is on. The trackpad page shows neither Secure Input nor Caps Lock.
Limits under Universal Bluetooth
Universal Bluetooth only sends standard HID reports, so these features are unavailable. The affected keys are dimmed and explain how to switch to Bluetooth, LAN or USB:
- Clipboard sync.
- Dictation.
- Text keys containing non-ASCII characters.
- Unmapped media keys, such as some brightness keys.
Normal keys, modifiers, trackpad gestures, volume and playback media keys, and the gamepad still work.
Apple Watch (optional)
watchOS 11 and later offers an optional Watch app: drag with one finger to move the pointer, tap to click, press and hold to drag, scroll with the Digital Crown, and use a separate slides page. The watch must stay in the foreground with the screen on; lowering the wrist or switching apps suspends it. It connects directly to the Mac over BLE and does not need the iPhone.