VKeyboard
A floating keyboard window for visionOS eye and hand input.
What It Is
VKeyboard is a floating virtual keyboard designed for Apple Vision Pro. It appears as a standard window in your space, rendered with the same visual style as your terminal. You can type by looking at keys and pinching, or by using direct hand interaction.
The keyboard supports both tap typing and swipe-to-type (QuickPath-style) — drag your gaze or finger across letters to spell words, and vmux predicts what you meant.
Opening the Keyboard
Open VKeyboard from the Command Palette or from Settings. It appears as a separate plain window.
Typing
- Tap typing — Look at a key and pinch to press it. The key highlights as you hover over it.
- Swipe typing — Start on one letter, drag across the letters of your word without lifting, then release. vmux shows a live preview of the predicted word above the keyboard. If the prediction is wrong, the fallback is the literal characters you crossed.
An output bar at the top of the keyboard shows what you've typed, along with a live words-per-minute counter.
Modifiers
The keyboard includes modifier keys (Shift, Ctrl, Alt, Fn) that work as one-shot toggles — tap to arm, then press the next key. Fn remaps certain keys:
| Key | With Fn |
|---|---|
| Backspace | Delete Forward |
| Left Arrow | Home |
| Right Arrow | End |
| Up Arrow | Page Up |
| Down Arrow | Page Down |
Position & Layout Settings
Adjust where the keyboard appears in your space. These settings are available in Settings under the keyboard section.
Position
- Scale — Overall size of the keyboard (default:
3.0) - Pitch — Tilt angle in degrees (default:
90) - Floor Lift — Height above the floor in mm (default:
3.0) - Front Offset — Distance toward you in mm (default:
42.0)
Appearance
- Key Font Size — Size of the primary key labels (default:
7.0) - Secondary Font Size — Size of secondary key labels (default:
4.6) - Panel Line Width — Stroke width of the keyboard panel border (default:
0.65) - Key Line Width — Stroke width of individual key borders (default:
0.65) - Panel Stroke Opacity — Border opacity of the outer panel (default:
0.45) - Key Stroke Opacity — Border opacity of individual keys (default:
0.42)
Cursor
The cursor that follows your gaze has three visual layers you can adjust:
- Halo Opacity — Soft outer glow (default:
0.20) - Ring Opacity — Circle outline (default:
0.62) - Core Opacity — Center dot (default:
0.78)