11.Settings
11 Settings
The Settings dialog manages WxTerm’s global options. Its navigation tree is organized into five groups: Theme Preferences, Terminal, Connection, Keyboard, and Cloud Sync.
11.1 Open Settings
- Menu “Options → Settings”, or the shortcut
Ctrl+,(Cmd+,on macOS). - The “Settings” button in the toolbar.
11.2 Dialog Layout
A tree navigation sits on the left; the selected page’s options are shown on the right. Navigation tree:
├─ Theme Preferences
├─ Terminal
│ ├─ Overview (cursor, blink, scrollback, default encoding)
│ ├─ Cursor Style (cursor style, blink)
│ ├─ Misc Settings (scrollback, default encoding)
│ ├─ Background Image (mode, image path, opacity)
│ └─ Advanced Settings (font, font size, antialiasing, terminal type, color mode, etc.)
├─ Connection
│ ├─ Overview (default protocol, auto reconnect, SSH keep-alive, connection timeout)
│ ├─ Default Settings (default protocol, auto reconnect)
│ ├─ Timeout (SSH keep-alive, connection timeout)
│ └─ SSH (SSH compression, SSH agent forwarding)
├─ Keyboard (backspace, delete, Home/End key mappings)
└─ Cloud Sync (sync toggle and sync contents)
“Terminal” and “Connection” are expandable group nodes: clicking the group name opens its overview page; expanding it reveals the sub-pages. Overview pages gather the most frequently used items, while the sub-pages provide the full set of options.
11.3 Theme Preferences
| Setting | Description | Default |
|---|---|---|
| Theme font | UI font family and font size | System default / 12 |
| Theme switching | Auto-switch mode: follow system / switch by time / disabled | Disabled |
| UI dark/light theme | Themes used when auto-switching the UI | Current theme |
| Terminal dark/light theme | Themes used when auto-switching the terminal | Current theme |
| Dark/light theme start | Switch times when switching by time | 18:00 / 06:00 |
11.4 Terminal Settings
Overview Page
Gathers four frequently used settings: cursor style, cursor blink, scrollback lines, and default encoding.
Cursor Page
| Setting | Description | Default |
|---|---|---|
| Cursor style | Block / Underline / Bar | Block |
| Cursor blink | Enable cursor blinking | On |
Misc Page
| Setting | Description | Default |
|---|---|---|
| Scrollback lines | Number of history lines the terminal can scroll back | 5000 |
| Default encoding | Default character encoding for new sessions | UTF-8 |
Background Image Page
| Setting | Description | Default |
|---|---|---|
| Background mode | None / Terminal only / Whole app | None |
| Image path | Background image file (PNG/JPEG supported) | — |
| Opacity | Background image opacity 0.0~1.0 | 0.5 |
The background image feature is available in all plans.
Advanced Page
| Setting | Description | Default |
|---|---|---|
| Font | Terminal font family | Default Monospace |
| Font size | Terminal default font size | 14 |
| Font antialiasing | None / Normal / Subpixel | Subpixel |
| Terminal type | Terminal emulation type for new sessions (xterm, etc.) | xterm |
| Color mode | None / 16 colors / 256 colors / True color | True color |
| Copy on select | Copy to clipboard immediately after selecting text | Off |
| Clickable links | URLs in the terminal can be clicked to open | On |
| Paste dialog for multiline text | Show a confirmation dialog before pasting multiline content | On |
| GL rendering acceleration | GPU-accelerated rendering (takes effect after restart) | On |
11.5 Connection Settings
Overview Page
| Setting | Description | Default |
|---|---|---|
| Default protocol | Protocol preselected when creating a new session | SSH |
| Auto reconnect | Reconnect automatically after a connection drops | Off |
Default Settings Page
| Setting | Description | Default |
|---|---|---|
| Default protocol | Protocol preselected when creating a new session | SSH |
| Auto reconnect | Reconnect automatically after a connection drops | Off |
Timeout Page
| Setting | Description | Default |
|---|---|---|
| SSH keep-alive | Interval between SSH keepalive packets (seconds); 0 disables | 60 |
| Connection timeout | Timeout for establishing a connection (seconds) | 30 |
SSH Page
| Setting | Description | Default |
|---|---|---|
| SSH compression | Enable SSH protocol compression | Off |
| SSH agent forwarding | Enable SSH Agent forwarding | Off |
11.6 Keyboard Settings
| Setting | Description | Options |
|---|---|---|
| Backspace key mapping | Character sent by the Backspace key | ^H (ASCII 8) / ^? (ASCII 127) |
| Delete key mapping | Character sent by the Delete key | ^H / ^? |
| Home/End key mapping | Escape sequences for Home/End keys | Standard / rxvt / VT100+ |
Backspace and delete mappings vary between servers. If pressing Backspace prints
^Hinstead of deleting, switch to^?(and vice versa).
11.7 Cloud Sync Settings
| Setting | Description |
|---|---|
| Enable cloud sync | Master toggle |
| Sessions | Sync session configurations |
| Settings | Sync global settings |
| Custom themes | Sync custom themes |
| Keymap | Sync keyboard mappings |
The cloud sync toggle is only available when signed in with a plan that supports it (paid plans required). See 10 Account, Activation & Cloud Sync.
11.8 Save and Cancel
- OK: Save all changes and close the dialog.
- Cancel: Discard changes and close the dialog.
- The close button (×) is equivalent to Cancel.
Changes take effect immediately after saving — no restart required (except GL rendering acceleration, which requires a restart).