09 Personalization

WxTerm provides rich personalization options: UI themes, terminal themes, custom themes, background images, fonts, keymap editor, and UI language.

9.1 Theme System

WxTerm’s themes are divided into two layers:

Theme type	Scope	Switch entry
UI theme	Application UI (title bar, menu, sidebar, dialogs, etc.)	Menu “Options → UI Theme”
Terminal theme	Terminal area color scheme (foreground, background, ANSI 16 colors)	Menu “Options → Terminal Theme”

The two are configured independently and can be freely combined (e.g. dark UI + light terminal).

Built-in Themes

Both UI themes and terminal themes are categorized by “Dark / Light”, with multiple built-in color schemes.

Switch UI Theme

1. Menu “Options → UI Theme”.
2. In the submenu, select the “Dark” or “Light” category.
3. Select a specific theme name.

Switch Terminal Theme

1. Menu “Options → Terminal Theme”.
2. In the submenu, select the “Dark” or “Light” category.
3. Select a specific theme name.

Quick Switch

• The “Theme” button on the right of the title bar can quickly switch between common themes.

Sci-Fi Theme

WxTerm has a special “Sci-Fi” UI theme; when enabled:

• The welcome screen’s action cards display HUD-style sci-fi corner decorations (cyan L-shaped corners).
• The overall color scheme leans toward a cyberpunk style.

9.2 Custom Theme

In addition to built-in themes, you can create fully custom themes, freely configuring every color.

Open the Custom Theme Editor

• Menu “Options → Custom Theme”.

Editor UI

Configurable color categories include:

• UI colors: background, secondary background, hover, text, muted text, border, accent, etc.
• Terminal colors: foreground, background, ANSI 16 colors (black/red/green/yellow/blue/magenta/cyan/white and their bright variants), cursor color, selection color, etc.

Color Selection

• Each color item shows a hex input box + a color block preview.
• Click the color block to open a color picker (with a saturation/value panel + hue bar).
• You can also directly enter a hex color value in the input box.

Theme Name and Multi-language Translation

• You can set multi-language names for a theme (Theme Translation); each language shows the corresponding theme name.
• At least one language name must be set.

Save and Apply

• Click “Save” to save the theme to themes.json in the configuration directory (configuration directory location see 01 Getting Started & UI Overview).
• After saving, it is automatically applied and appears in the theme switch menu.

Custom theme feature is available in all plans.

9.3 Background Image

You can set a background image for the terminal or the entire application.

Configuration Entry

• Menu “Options → Settings” → “Terminal” page → Background image area.
• Or find the background image configuration in menu “Options → Settings”.

Configuration Fields

Field	Description
Mode	None / Terminal only / Entire app
Image path	Local image file path
Opacity	0.0 ~ 1.0, controls background image transparency

• Terminal only: the background image is only shown in the terminal area; UI elements keep the theme color.
• Entire app: the background image fills the entire window; the title bar, menu bar, sidebar, etc. become semi-transparent overlaid on the background image.

Background image feature is available in all plans.

9.4 Font Settings

Open Font Settings

• Menu “Options → Font Size”.

Configuration Fields

Field	Description
Font size	Terminal font size, in px
Font family	Multi-select, fallback by priority (e.g. prefer a monospace font, fall back to system default)

Font Family Selection

• The list shows monospace fonts available on the system.
• After checking multiple fonts, the terminal tries to render in the checked order, falling back to the next when a glyph is missing.
• Suitable for CJK users: select an English monospace font + a Chinese font to avoid Chinese being displayed in the system default font.

Temporary Zoom

• Ctrl+= / Ctrl+- / Ctrl+0 can temporarily adjust the current session’s font size (does not affect global settings).

9.5 Keymap Editor

WxTerm supports fully custom keyboard shortcut mappings.

How to open

• Menu “Options → Keymap Editor”.
• Toolbar “Keymap Editor” button.

Editor UI

Keymap Entries

Each mapping contains:

Field	Description
Key combo	e.g. Alt+Ctrl+Down
Action type	send (send chars) / menu (trigger menu) / scroll (scroll) / telnet / vt / tn3270 / ssh / script / app / disable
Parameter	Action parameter (e.g. the char sequence to send, the menu action name)
Parameter	Additional parameter for script/app actions
System	Whether it is a system built-in mapping (read-only, cannot be deleted)

Operations

• Add: click “Add”, and in the bottom edit panel, enter the key combo, select the action type and parameters.
• Edit: select an entry and click “Edit” to modify.
• Delete: delete user custom mappings (system mappings cannot be deleted).
• Show system shortcuts: check/uncheck to filter the display of system built-in mappings.

Action Type Description

Action	Description	Parameter example
send	Send a char sequence to the terminal	\x1b[A (up arrow escape)
menu	Trigger a menu action	quick-connect
scroll	Scroll the terminal	up / down / page-up / page-down
telnet	Telnet protocol command	—
vt	VT100 escape sequence	—
tn3270	3270 terminal command	—
ssh	SSH operation	—
script	Run a script	script name
app	App operation	—
disable	Disable this key	—

Save

• After modifying, click “Save”; the mappings are written to keymap.json in the configuration directory (configuration directory location see 01 Getting Started & UI Overview) and take effect immediately.

Keymap editor feature is available in all plans.

9.6 UI Language

WxTerm supports 20+ UI languages, and supports RTL (right-to-left) languages such as Arabic.

Supported Languages

Language	Code	Direction
Simplified Chinese	zh-CN	LTR
Traditional Chinese (Taiwan)	zh-TW	LTR
Traditional Chinese (Hong Kong)	zh-HK	LTR
English	en	LTR
German	de	LTR
Spanish	es	LTR
French	fr	LTR
Italian	it	LTR
Portuguese	pt	LTR
Russian	ru	LTR
Japanese	ja	LTR
Korean	ko	LTR
Arabic	ar	RTL
Hindi	hi	LTR
Indonesian	id	LTR
Dutch	nl	LTR
Polish	pl	LTR
Swedish	sv	LTR
Thai	th	LTR
Turkish	tr	LTR
Vietnamese	vi	LTR

Switch Language

1. Menu “Options → Language”.
2. In the submenu, select the target language.

Or quickly switch via the “Language” button on the right of the title bar.

RTL Support

After selecting an RTL language such as Arabic:

• All horizontal layouts (HorizontalLayout / GridLayout) are automatically mirrored.
• Text alignment direction is adjusted.
• Icon directions are flipped as needed.
• When switching languages, the UI direction takes effect immediately without restarting.

After switching languages, the UI direction (LTR/RTL) is automatically reapplied without manual action.