Settings Reference
All vmux settings in one place.
Opening Settings
Press Cmd+, or select Open Settings from the Command Palette. All changes apply immediately and are saved automatically across sessions.
Settings are organized into two tabs: Options and Keyboard.
Options Tab
Font
| Setting | Type | Description | Default |
|---|---|---|---|
| Font | Picker | Choose from installed Nerd Fonts. Tap to browse the full font picker | JetBrains Mono |
| Font Size | Slider | Text size in points (8 – 32) | 14 pt |
| Weight | Picker | Regular or Bold | Regular |
See Fonts for details on installing and importing fonts.
Appearance
| Setting | Type | Description | Default |
|---|---|---|---|
| Theme | Picker | Color scheme for the terminal. Tap to browse or import VSCode themes | Ghostty |
| Opacity | Slider | Background opacity from 0% (transparent) to 100% (solid) | 50% |
| Glass Background | Toggle | Enable the visionOS glass material behind the terminal | On |
| Glass Style | Picker | Regular (frosted) or Clear (more transparent). Only visible when Glass Background is on | Regular |
See Themes and Glass & Opacity for more.
Terminal
| Setting | Type | Description | Default |
|---|---|---|---|
| Cursor Style | Picker | Shape of the text cursor — Block, Hollow Block, Underline, or Bar | Block |
| Blink Cursor | Toggle | Animate the cursor with a blinking effect | On |
| Option as Meta | Toggle | Send the Option key as Meta/Alt for programs like vim and emacs | On |
| Allow Mouse On Primary Buffer | Toggle | Forward mouse events to programs on the primary screen buffer (not alternate). Disable to use mouse for text selection only | On |
| Character Spacing | Slider | Horizontal spacing multiplier between characters (0.80 – 1.50) | 1.00 |
| Line Spacing | Slider | Vertical spacing multiplier between lines (0.80 – 2.00) | 1.00 |
| Send COLORTERM | Toggle | Set COLORTERM=truecolor so programs use 24-bit color | On |
| Confirm Close Connected | Toggle | Show a confirmation prompt before closing a window with an active connection | On |
| Pane Borders | Toggle | Draw a visible border around each pane | On |
| Pane Border Opacity | Slider | Opacity of pane borders (0% – 100%). Only visible when Pane Borders is on | 100% |
Pane Organization
| Setting | Type | Description | Default |
|---|---|---|---|
| Navigation Mode | Picker | How windows are organized — Multi-Window (separate visionOS windows) or Pane Tabs (tabbed within a single window) | Pane Tabs |
| Battlestation Mode | Toggle | Arrange open windows in a fixed multi-monitor-style formation | Off |
CRT Effects
| Setting | Type | Description | Default |
|---|---|---|---|
| CRT Effect | Toggle | Master toggle for all CRT screen effects | Off |
| Scanlines | Slider | Horizontal scanline intensity | 70% |
| Vignette | Slider | Corner and edge darkening | 50% |
| Flicker | Slider | Brightness flicker | 0% |
| Noise | Slider | Static grain overlay | 0% |
| Tint | Slider | Green phosphor color tint | 0% |
| Barrel | Slider | Barrel distortion / screen curvature | 30% |
| Chromatic | Slider | Chromatic aberration (color fringing) | 50% |
| Interlace | Toggle | Alternating scanline interlace effect | Off |
| Bloom | Slider | Glow intensity around bright text | 0% |
| Bloom Threshold | Slider | Minimum brightness for bloom to appear | 50% |
| Bloom Radius | Slider | How far bloom spreads from bright areas | 40% |
| Phosphor Decay | Slider | Persistence trail on moving text | 0% |
| Shadow Mask | Slider | Subpixel shadow mask pattern | 0% |
CRT sliders only appear when the master CRT Effect toggle is on. See CRT Effects for a visual guide.
Security
| Setting | Type | Description | Default |
|---|---|---|---|
| App Lock | Toggle | Lock the app when backgrounded. Requires biometric authentication (Face ID or Optic ID) to unlock | Off |
See Security for more details on app lock and credential storage.
Diagnostics
| Setting | Type | Description | Default |
|---|---|---|---|
| Export Diagnostics | Button | Copies an anonymized JSON diagnostic report to the clipboard. No hostnames, passwords, or usernames are included | — |
Keyboard Tab
Keybinds
Tap Edit to open the keybind editor. The editor now shows one flat command list (palette commands + direct input commands), with unique namespaced IDs and no overlaps.
You can assign a shortcut to any command. For slider/picker commands, the shortcut opens the command palette editor for that command.
See Keyboard Shortcuts for the keybind reference.
VKeyboard — Size & Position
| Setting | Type | Description | Default |
|---|---|---|---|
| UI Scale | Slider | Overall size of VKeyboard (1.0 – 6.0) | 3.0 |
| Pitch | Slider | Angle in degrees — 0 is vertical, 90 is flat (0 – 90) | 90 |
| Floor Lift | Slider | Height above the floor in millimeters (0 – 20) | 3 mm |
| Front Offset | Slider | Distance in front of you in millimeters (0 – 80) | 42 mm |
VKeyboard — Key Appearance
| Setting | Type | Description | Default |
|---|---|---|---|
| Font Size | Slider | Key label font size (4 – 16) | 7.0 |
| Key Line Width | Slider | Border thickness around each key (0.5 – 3.0) | 0.65 |
| Key BG Opacity | Slider | Background opacity of individual keys | 24% |
| Panel Opacity | Slider | Background opacity of the keyboard panel | 50% |
| Idle Stroke | Slider | Key border opacity when not targeted | 42% |
| Hover Stroke | Slider | Key border opacity when targeted by gaze | 95% |
VKeyboard — Cursor & Interaction
| Setting | Type | Description | Default |
|---|---|---|---|
| Cursor Halo | Slider | Outer glow opacity of the gaze cursor | 20% |
| Cursor Ring | Slider | Ring opacity of the gaze cursor | 62% |
| Cursor Core | Slider | Center dot opacity of the gaze cursor | 78% |
| Swipe Trail | Slider | Opacity of the trail left by swipe gestures | 92% |
| Swipe Reachability Dimming | Toggle | Dim keys outside the swipe reach zone | On |
A Reset to Defaults button at the bottom of the Keyboard tab restores all VKeyboard settings to their original values.
Persistence
Settings are saved automatically as you make changes. They persist across app launches and apply to all windows.
Passwords are stored separately in the system Keychain — they're never included in the settings file. See SSH Connections for more on credential storage.
Related
- Command Palette — quick access to all commands
- Themes — browsing and importing themes
- Fonts — font selection and import
- Glass & Opacity — glass background details
- CRT Effects — CRT effect deep dive
- Keyboard Shortcuts — keybind reference
- Security — app lock and credential storage