Skip to main content

Customization

Termia's look is controlled from one place: the Appearance tab of Settings. Open it from the File menu (File > Settings) or by clicking your avatar in the tab bar, then choose Appearance in the left rail. Inside, a "Quick Style" panel groups four things: the overall color theme, the terminal font, interface transparency/blur, and a per-tab background image.

Light, dark, and system appearance​

Choose appearance before adjusting terminal-specific colors and fonts.
Choose appearance before adjusting terminal-specific colors and fonts.View full size ↗

At the top of the Appearance tab, three buttons switch the app's overall appearance: System, Light, Dark. This writes the termia:theme setting ("system", "light", or "dark", default "dark"). In "system" mode Termia follows the OS prefers-color-scheme media query and updates live if you change your OS setting while the app is open.

The whole UI ships two token sets — one for light, one for dark — defined in frontend/app/theme.scss under the .dark and .light scopes. Every built-in surface (tab bar, side rail, dialogs, terminal chrome) is themed from these tokens, so switching modes never leaves part of the interface unreadable. If you build custom UI, this repo's convention is to always define a color as a token in both scopes, not as a fixed hex value.

Switching modes also restores whichever color theme (below) you last used in that mode: Termia remembers your last light-mode pick and your last dark-mode pick separately, so flipping from dark to light and back returns you to where you were, not to the default.

Color theme (tab background + terminal palette)​

The Color Theme section shows a grid of preset cards. Each card is a small preview: a strip that shows the tab background, a bar below it colored with the terminal's background/foreground, and a row of eight swatches for the terminal's ANSI palette. Clicking a card applies both halves at once — the tab background preset and a matching terminal color theme — so the two never clash. Cards are filtered to the app mode you're currently in: light-mode cards only appear in light mode, and vice versa (the "Default" card has no mode restriction and appears in both).

Under the hood, choosing a card sets two independent config keys in one action:

  • tab:preset — which tab-background preset to use (see Presets for what a preset is and where these live)
  • term:theme — which terminal color theme to use (from pkg/wconfig/defaultconfig/termthemes.json, 20 themes ship by default: 14 dark, 6 light)

Applying a theme from this grid updates every open tab in the current workspace immediately, unless a tab has its own background image override (see below), in which case only that tab's accent-border color is refreshed and its custom background is left alone.

Terminal font and size​

The Terminal section has two dropdowns that set the default font size (term:fontsize) and font family (term:fontfamily) for every terminal that hasn't been overridden individually. Font size options run from 10px to 24px. The font family list is fixed to fonts this app knows are monospace and safe to fall back from:

Consolas, JetBrains Mono, Fira Code, Cascadia Code, Source Code Pro, IBM Plex Mono, Roboto Mono, Inconsolata, Ubuntu Mono, Hack

The actual default depends on your OS: Windows defaults to Consolas; macOS and Linux default to JetBrains Mono (bundled with the app, so it always renders even if not separately installed). Whatever you pick from the fallback stack above is expected to already be installed on your system for other platforms.

Per-terminal overrides​

Right-click the header of any terminal block for a context menu with its own Themes, Font Size, Font Family, and Transparency submenus. Anything you pick here overrides the global default for that one block only (stored as term:theme / term:fontsize / term:fontfamily / term:transparency in the block's own metadata); each submenu's first entry is always "Default" and clears the override, falling back to the global setting again. The Themes submenu groups all 20 shipped themes under "Dark Themes" and "Light Themes" headers so you can find one that matches your current app mode. Transparency here is a fixed set of steps — 0%, 25%, 50%, 75%, 100% — independent from the interface transparency slider described next.

Interface transparency and blur​

The Interface Effects section has two sliders:

  • Interface Transparency (0–90%) — applied globally to blocks, tabs, and the side toolbars (style:transparency)
  • Background Blur (0–24px) — blurs whatever shows through that transparency (style:backgroundblurpx)

The default transparency depends on context: 90% in dark mode, and either 50% or 45% in light mode depending on whether the current tab has a custom background image. The Reset button clears both keys back to those adaptive defaults rather than to a single fixed number, so resetting behaves correctly whichever mode and tab you're in.

Tab background image​

A tab background is a visual preference, not a connection setting.
A tab background is a visual preference, not a connection setting.View full size ↗

The bottom section lets you set an image background scoped to the current tab only. Drag an image onto the drop zone, or click it to open a file picker (accepts PNG, JPG, JPEG, WebP, GIF, BMP, SVG). Once set, two dropdowns become active:

  • Fill Mode — Cover, Contain, Fill, Repeat
  • Blend Mode — Normal, Overlay, Multiply, Screen, Darken, Lighten, Soft Light

The default blend mode is Multiply in dark mode and Normal in light mode, so a photo doesn't wash out the dark UI or go muddy on a light one. A tab with an image override keeps that image when you switch color themes; only the color theme's border accent updates around it. Click the small close button that appears over the preview thumbnail to clear the image and return the tab to the theme's own background.

Command line: wsh setbg​

The same per-tab background can be set from a terminal with wsh setbg, without opening Settings:

# Set an image background (defaults to center/cover, 50% opacity)
wsh setbg ~/pictures/background.jpg

# Set a solid color background (quote hex values so # isn't read as a shell comment)
wsh setbg "#1a1a2e"
wsh setbg forestgreen

# Positioning
wsh setbg --tile ~/pictures/texture.png                 # repeat
wsh setbg --center --size 200px ~/pictures/logo.png     # centered, unscaled unless --size given

# Opacity only (leaves the current image/color as-is)
wsh setbg --opacity 0.7

# Remove the background
wsh setbg --clear

# Preview the metadata this would apply, without applying it
wsh setbg --print ~/pictures/background.jpg

wsh setbg writes the tab's bg / bg:opacity metadata directly; it is a separate code path from the Fill Mode/Blend Mode picker above (which composes bgimg:* keys into bg for you), so mixing the two on the same tab is not recommended. See wsh Reference for the full command surface.

Language​

Termia's UI ships in four languages. Open Settings and choose Language in the left rail; each option is shown in its own language, not translated into whatever language is currently active:

  • English
  • 中文 (Chinese)
  • Español (Spanish)
  • 日本語 (Japanese)

Termia detects your OS/browser language on first launch and remembers your choice afterward (stored locally, per device). Selecting a language takes effect immediately, with no restart. Region-tagged locales (for example a system reporting zh-TW or es-MX) resolve to the closest shipped language automatically.

Monitor panes adapt automatically to full, vertical and horizontal layouts; the terminal bottom strip keeps readings live when minimized. See Monitoring for the illustrated modes and monitor skins.