Kterm

Kterm is a focused terminal emulator with high-quality GPU text, cyberpunk post-processing, and lightweight shell splits organized into up to nine named, numbered workspaces in one window. Each workspace has its own pane layout and running shells. Kterm intentionally omits status dashboards and hardware monitors.

Download v0.13.1

Download 0.13.1

Windows

macOS

Linux

Fedora

Debian / Ubuntu

Kterm provides:

See docs/vt-support-policy.md for the rationale and boundaries around tab-stop management, color queries, image graphics, working-directory reporting, palette mutation, and horizontal margins.

Themes

Use a built-in theme for one launch without changing kterm.toml:

kterm --theme rose-pine-dawn
kterm --config /path/to/kterm.toml --theme catppuccin-latte

--theme has higher precedence than the selected configuration file. Run kterm --list-themes to print the accepted names one per line. The override also applies to font preview and to elevated panes on Windows.

Linux installation

Fedora and Debian/Ubuntu packages are published for x86_64 and ARM64. Install the package for the current system with:

curl -fsSLo kterm-update https://kterm.kkutsner.dev/kterm-update
bash kterm-update
rm kterm-update

Installed packages include kterm-update; run it later to download, verify, and install the newest release. See docs/linux-installation.md for version selection and removal.

Windows installer

The per-user x64 MSI installs Kterm under %LOCALAPPDATA%\Programs\Kterm, adds Start menu shortcuts for Kterm, the offline quick start, and configuration editing, and registers uninstall through Windows Installed Apps. An Uninstall Kterm Start menu shortcut is also provided. Release packages are code-signed; packages you build yourself are unsigned, so Windows may show an unknown-publisher or SmartScreen warning for them.

Windows builds include Microsoft's standalone ConPTY runtime so image transfers and extended VT metadata reach Kterm unchanged. Keep conpty.dll and the architecture-specific OpenConsole.exe folders beside kterm.exe; the older Windows-provided console host discards Kitty image commands.

Kterm creates a diagnostic log for each launch in %LOCALAPPDATA%\kterm\logs on Windows, ~/.local/share/kterm/logs on Linux, or ~/Library/Application Support/kterm/logs on macOS. Runtime errors and Rust panic backtraces are recorded there for troubleshooting. Terminal input and screen contents are not logged.

Windows builds use the GUI subsystem by default, so launching kterm.exe from File Explorer does not open a separate console window. Informational commands such as --help and --list-themes attach to the invoking terminal when one exists. Elevated Windows panes show a peach Administrator label and shield while active, and expose the same status in the native window title used by Alt+Tab and accessibility tools. The active divider or zen frame also switches from the theme accent to the same peach color.

Configuration

Create kterm.toml in the platform configuration directory and restart Kterm to apply file changes. On Windows, the installed Edit Kterm Configuration Start menu shortcut opens the first existing file in the WinUI 3 settings editor, in the same order Kterm uses at startup. If none exists, it creates the commented default under %APPDATA%\kterm without overwriting existing settings:

Platform Configuration file
Windows %APPDATA%\kterm\kterm.toml, then ~\.config\kterm\kterm.toml
macOS ~/Library/Application Support/kterm/kterm.toml
Linux $XDG_CONFIG_HOME/kterm/kterm.toml, or ~/.config/kterm/kterm.toml when unset

For cross-platform compatibility, Kterm checks ~/.config/kterm/kterm.toml after the native platform location. It then falls back to kterm.toml in its working directory. The repository's sample file can be copied to any listed location and customized.

Windows settings editor

Click the gear immediately to the left of Minimize in the Windows custom titlebar to open Kterm Settings. The separate WinUI 3 window uses Fluent controls, follows the Windows light/dark theme, and uses Mica where supported. Its categories cover Window, Terminal, Clipboard, Panes, Picker, Keybindings, and Effects. Ctrl+F searches terminal settings across categories. Toggles control booleans, dropdowns select themes and display modes, and RGB color pickers provide a color spectrum, hex entry, and Use default reset. Color changes are committed with Use color; dismissing the picker leaves the setting unchanged. The Appearance controls share one terminal-style preview in a fixed, non-scrolling block above the independently scrollable properties. In short windows or at large font metrics, the sample is cropped rather than shrinking the configured typography, leaving room to edit the controls. The theme dropdown shows friendly names and 16-color ANSI palette thumbnails. The shared sample follows the selected theme, font family, weight, size, line height, and draft foreground/background overrides; an override notice explains when custom colors replace theme defaults. It uses Kterm's font data but does not simulate glow, transparency, or terminal-specific GPU geometry. Previewing never saves the file or changes running terminals, and the saved theme identifiers remain unchanged. The font selector provides searchable installed monospace families and an explicit Bundled (JetBrains Mono) entry. Font-list samples and the shared appearance preview use Kterm's own font data, including embedded Nerd Font symbols, without installing fonts. Named weights reflect available faces; Exact weight preserves custom numeric values. Size and line height remain independently editable, and the preview follows draft theme colors. Missing or proportional family names remain saveable for other machines; a notice identifies the bundled fallback and the closest regular face when an exact weight is unavailable. Sliders adjust fonts, spacing, opacity, pane percentages, and visual effects, with exact numeric entry alongside them. Numeric limits and invalid-value feedback are shown without silently rounding existing values. Window sizes and large history/clipboard counts use numeric entry rather than sliders. Array controls use one editable row per item with Add and Remove actions, rather than TOML syntax. Arguments preserve spaces, empty values, and embedded line breaks exactly. Blank optional shell fields and default color resets remove overrides.

Save (or Ctrl+S) validates the current file's complete configuration before replacing it. Existing comments and unchanged settings, including omitted defaults, are preserved. Close prompts before discarding unsaved changes. Kterm serializes saves to the same file and checks for external edits before and after staging the replacement. Detected conflicts refuse the save; use Reload to load external changes, with confirmation before discarding edits. External editors do not participate in Kterm's save lock, so avoid saving simultaneously from another application. Backend operations have a 30-second deadline. If the backend stops or times out, the draft stays in the window and Reload reconnects, with confirmation before discarding edits. An interrupted save may already have completed; reload the file to confirm its contents before retrying. Open TOML opens the same file in your associated editor (or Notepad). Restart Kterm to apply saved terminal settings; favorites apply when the picker next opens. The editor does not restart shells or live-apply changes to running processes.

The gear edits the configuration selected when the terminal started, including an explicit --config PATH, not temporary font changes or a --theme override. Repeated clicks bring the existing settings window forward. With native decorations, use the Start menu shortcut or kterm --edit-config [--config PATH] instead. The GUI editor and gear are Windows-only; kterm --edit-picker-config [--config PATH] opens the dedicated Picker favorites window directly. Its --config selects a picker favorites file, not the main terminal configuration.

Click Manage favorites... on the Picker settings page to open Picker favorites. Repeated clicks bring the same favorites window forward, including restoring it when minimized. This separate, non-modal window has no general settings navigation; Ctrl+F searches its entries. It edits picker.kterm.toml: add, remove, and reorder entries, then edit names, descriptions, programs, arguments, working directories, tags, platform checkboxes, and exit/wait policies. It uses the same master-detail navigation as main Settings: favorites and search in the left pane, with the selected favorite's Details, Launch, and Availability & exit controls on the right. The navigation collapses on narrow windows; use its menu button to choose a favorite, then edit in the full-width detail page. Filtering the navigation keeps the current favorite's editor and draft intact until you select another entry. Arguments, tags, and specific exit codes use item rows; exit codes have inline numeric validation. Platform labels display Windows, Linux, and macOS while preserving their lowercase TOML values. No platform selection means every platform. Use the default wait condition with close; conditions such as On failure or specific exit codes apply only to wait-for-key. The Picker category still controls enabling and launching the picker itself.

The navigation pane displays the current file name and conventional Windows path without the internal \\?\ canonicalization prefix. Change file opens a path flyout; Open config selects another path, including a profile selected through [picker].args = ["--config", "PATH"]; a missing file is created from the bundled picker template. The initial path follows the picker's native/legacy search order unless --edit-picker-config --config PATH selects it explicitly. Custom launch arguments are not automatically inferred by the settings editor. For a relative picker path, select the matching absolute path: the picker resolves it against its launch directory, which may be the active pane's working directory. Each window's Save, Reload, Open TOML, and close confirmation apply only to its own file. Neither window saves or discards the other's draft. Closing Settings leaves an open favorites window running, and closing favorites leaves Settings usable. Favorites are validated by the same schema as kterm-picker, including name uniqueness, argument limits, platforms, and exit policies. Comments and untouched values are preserved, and external edits require Reload rather than being overwritten. Saved favorites take effect the next time the picker opens; terminal settings still require a Kterm restart.

The Windows installer includes a Native AOT settings editor and the WinUI runtime components it needs; no separate .NET or Windows App SDK installation is needed. It excludes unused SDK AI/ML and widgets modules, the full .NET runtime, and debug symbols. Keep the entire settings folder beside kterm.exe when copying a development build.

Kterm configuration reference

Unknown sections and fields are rejected, except legacy [kgit] and keybindings.kgit_open entries, which are accepted but ignored. The settings editor preserves these entries without exposing them. The dedicated Kgit integration and shortcut have been removed; Ctrl+Shift+G is forwarded to the terminal unless configured for another action. Git tools can still be launched normally from a shell or picker favorite. Every section and field is optional; omitted values use the defaults below. Windows cannot be resized below 480 x 320 logical pixels, with either custom or native decorations. Older configured sizes below that minimum must be repaired in the settings editor or TOML file before starting Kterm.

Field Default Accepted value
window.title kterm <version> UTF-8 string, 0-4096 bytes
window.width 1280 Integer logical pixels, 480-8192
window.height 760 Integer logical pixels, 320-8192
window.transparent false true or false
window.background Terminal background CSS-style "#RRGGBB" sRGB color
window.decorations "custom" "custom" or "native"
terminal.shell Platform shell Executable name or path, 1-4096 UTF-8 bytes; no arguments
terminal.theme "catppuccin-mocha" A built-in Catppuccin, Rosé Pine, or Everforest flavor listed below
terminal.font_family Bundled JetBrains Mono Fontconfig family, 1-1024 UTF-8 bytes after trimming
terminal.font_weight 100 Integer OpenType/CSS weight, 1-1000
terminal.font_size 14.0 Finite logical pixels, 6.0-72.0
terminal.line_height 24.0 Finite logical pixels, 1.0-256.0
terminal.padding 8.0 Finite logical pixels per edge, 0.0-256.0
terminal.foreground Theme value CSS-style "#RRGGBB" sRGB color
terminal.background Theme value CSS-style "#RRGGBB" sRGB color
terminal.background_opacity 1.0 Window and default terminal background opacity, 0.0-1.0
terminal.scrollback_lines 10000 Integer lines, 0-1000000
clipboard.osc52_write true true or false
clipboard.osc52_max_bytes 1048576 Integer bytes, 1-16777216
panes.resize_step_percent 2 Integer percentage points per key action or wheel line, 1-40
panes.mouse_wheel_resize true true or false
panes.zoom_mode "default" "default", "none", or "zen"
panes.zen_size_percent 85 Integer percent, 50-100
picker.enabled false true or false
picker.program "kterm-picker" Executable name or path, 1-4096 UTF-8 bytes
picker.args [] 0-256 strings, each 0-16384 UTF-8 bytes

All [keybindings] values use modifier+modifier+physical-key strings. Accepted modifier names are ctrl/control, shift, alt, and super/meta/win; each modifier may appear at most once and modifiers match exactly. Accepted physical keys are a-z, 0-9, equal, minus, slash, backslash, left, right, up, down, enter, tab, space, home, end, page-up, page-down, insert, delete, numpad-add, numpad-subtract, and f1-f12. Each binding requires exactly one key. Enabled actions cannot duplicate one another or use reserved pane and paste combinations: Ctrl+1-9, Ctrl+H/J/K/L, Ctrl+Slash/Backslash, Ctrl+Shift+W/H/J/K/L/Arrow, and Ctrl(+Shift)+V. keybindings.restart_elevated is accepted on every platform but acts only on Windows.

Keybinding field Default
keybindings.font_increase "ctrl+equal"
keybindings.font_decrease "ctrl+minus"
keybindings.pane_grow "ctrl+shift+equal"
keybindings.pane_shrink "ctrl+shift+minus"
keybindings.pane_swap_left "ctrl+alt+h"
keybindings.pane_swap_down "ctrl+alt+j"
keybindings.pane_swap_up "ctrl+alt+k"
keybindings.pane_swap_right "ctrl+alt+l"
keybindings.zoom_mode_cycle "ctrl+shift+z"
keybindings.picker_open "ctrl+shift+p"
keybindings.restart_elevated "ctrl+shift+enter"
Effects field Default Accepted value
effects.glow_strength 0.0 Finite multiplier, 0.0-3.0
effects.glow_radius 0.0 Finite physical pixels, 0.0-10.0
effects.cursor_glow true true or false
effects.chromatic_aberration 0.0 Finite physical pixels, 0.0-10.0
effects.scanline_strength 0.075 Finite strength, 0.0-1.0
effects.vignette_strength 0.32 Finite strength, 0.0-1.0
effects.noise_strength 0.018 Finite strength, 0.0-1.0

Use Ctrl+Equal/Minus to adjust font size temporarily; line height scales with it and the PTY grid resizes immediately. The Windows titlebar follows at half that rate, bounded between 0.75x and 3x its startup size. The Linux custom titlebar follows the same scaling behavior. font_size, line_height, and padding are logical-pixel values and automatically follow the monitor's HiDPI scale factor.

Use Ctrl+/ to split the active pane vertically and Ctrl+\ to split it horizontally. Use Ctrl+Shift+W to close the active pane; closing its workspace's final pane removes that workspace. Kterm exits only when no workspaces remain. On Windows, use Ctrl+Shift+/ or Ctrl+Shift+\ for the corresponding elevated split. Kterm shows UAC, then hosts the administrator shell in the new pane while the rest of the window remains unelevated. Cancelling UAC leaves the existing workspace unchanged. Use Ctrl+Shift+Enter to replace the active unelevated pane with a fresh administrator shell. The pane keeps its layout and working directory, but its current shell, applications, jobs, and scrollback are terminated and cannot be restored. Cancelling UAC leaves the original pane running. See docs/windows-elevated-panes.md for the process model, security boundary, visual indicators, and limitations.

Workspaces

Use Ctrl+1-9 to switch workspaces. A missing number creates a workspace only when the preceding number exists; workspace 1 can always be recreated. In the Windows/Linux custom titlebar, click a number to switch or click + to create the lowest free number. Numbers remain stable when a workspace is removed, and there are at most nine workspaces. Native decorations retain keyboard switching but do not display the workspace controls.

Click the italic, accent-colored workspace name to rename it inline. Enter or clicking away saves a valid name; Escape cancels. Blank names, multiline pastes (including Unicode line separators), and edits exceeding 31 visible characters are rejected without changing the name. Accented letters and joined emoji count as one character each; a 4096-byte UTF-8 safety limit also applies. Dragging the name still moves the window. Hidden workspaces keep their shells running and drain output without changing the active workspace's title, clipboard, or pane focus. Pane zoom mode and zen viewport size are workspace-local.

Closing the window saves workspace names, stable numbers, active workspace/pane, split topology and sizing shares, preview dimensions, zoom mode, and valid local working directories. Startup automatically restores that layout with fresh shells from the current configuration, not running commands, scrollback, picker stacks, or jobs. Saved elevated panes require fresh UAC approval off the event-loop thread. Cancelling approval restores that pane as an unelevated shell without discarding the other workspaces; the next save records its actual unelevated state.

The first instance acquires exclusive saved-state ownership once at startup. Secondary instances restore the same saved layout but discard changes when closed, even if the original owner has exited. A newly started instance may then become the owner. This applies across configuration overrides as well. State is atomically replaced at normal shutdown; forced termination and fatal terminal errors do not save changes.

The versioned state file is %LOCALAPPDATA%\kterm\workspaces.json on Windows, ~/.local/share/kterm/workspaces.json on Linux (respecting the platform data directory), and ~/Library/Application Support/kterm/workspaces.json on macOS. Invalid or unsupported state stops startup with an error rather than silently replacing the saved layout. Move the state file aside to start fresh. An empty saved set starts with workspace 1.

Pane picker

Set [picker].enabled = true to route those same split shortcuts through the bundled kterm-picker. The picker runs unelevated, preserves the new pane's identity when launching a selection, and defers UAC until after a selection made from a shifted split shortcut. Favorites come from picker.kterm.toml in Kterm's user configuration directory; copy picker.kterm.toml.example as a starting point. Escape or q cancels the split, while the initially selected Default shell entry preserves a quick split-then-Enter workflow. Use configurable Ctrl+Shift+P to open the same picker temporarily in the active pane. The current process keeps running, continues receiving pane resizes, and returns when the picker is cancelled or the selected process exits. Invoking the shortcut from a selected process creates a LIFO stack, so nested selections return in reverse order. Closing the pane still terminates the whole stack. The shortcut passes through to terminal applications while picker integration is disabled. A selected process's validated launch directory remains available to nested pickers even when that process does not emit OSC working-directory metadata. The picker displays at most ten entries at once and adds a scrollbar for longer filtered lists. Favorite names must be unique after trimming and case folding. Each favorite accepts exit_behavior = "close" (the default) or "wait-for-key" to preserve the process's final screen until a key is pressed. In an active-pane picker, that key returns to the parked process. With "wait-for-key", optional wait_for_key_on controls which outcomes pause: "always" is the default, "failure" matches nonzero exits and signals, "success" matches exit code zero, and an array such as [2, 10] matches exact exit codes. Exact-code arrays never match signal exits. wait_for_key_on is invalid with exit_behavior = "close". Unmatched outcomes return or close immediately; matching outcomes show the exit result and accept any key. Omitting working_directory is equivalent to "inherit" and starts the favorite in the directory reported by the pane from which the picker was opened. Selected processes use Kterm's environment, not runtime environment changes made inside the parked shell. Windows installations include an Edit Kterm Picker Configuration Start menu shortcut, which opens the WinUI favorites editor. Open TOML remains available for direct text editing. Pass --config PATH through [picker].args to select an explicit favorites file.

Picker configuration reference

picker.kterm.toml rejects unknown fields and supports exactly version = 1 with up to 256 [[favorites]] entries.

Favorite field Default Accepted value
name Required Non-empty and unique after trimming/case folding; at most 256 UTF-8 bytes
description "" UTF-8 string, 0-1024 bytes
program Required Executable name or path, 1-4096 UTF-8 bytes
args [] 0-256 strings, each 0-16384 UTF-8 bytes
working_directory "inherit" Exact value "inherit" or a non-empty path of at most 4096 UTF-8 bytes
tags [] 0-32 unique non-empty strings, each at most 64 UTF-8 bytes
platforms [] Unique values from "windows", "linux", and "macos"; empty means all
exit_behavior "close" "close" or "wait-for-key"
wait_for_key_on "always" With "wait-for-key": "always", "failure", "success", or up to 256 unique exit codes from 0 through 4294967295; omit with "close"

Navigate to the nearest pane with Ctrl+H/J/K/L, and move the active pane's nearest divider with Ctrl+Shift+H/J/K/L. Ctrl+Shift+Arrow remains an alternative resize binding. Each split assigns roughly 70% of its space to the branch containing the active pane. Inactive PTYs preserve columns for vertical previews or rows for horizontal previews, resize only the orthogonal dimension, and then scale uniformly to fill the smaller viewport. Click a pane to focus it, or drag any separator on the active pane's split path to resize it with the mouse. The cursor changes to show the divider's resize direction. Point at a pane, then hold Ctrl+Shift and scroll up or down to grow or shrink that pane along all available axes without changing focus. In zen mode, scrolling over the active floating pane changes the viewport size. Set panes.mouse_wheel_resize = false to disable this gesture and leave Ctrl+Shift wheel events to the normal terminal wheel path. Swap the active pane with its nearest neighbor using configurable Ctrl+Alt+H/J/K/L. Alternatively, hold Ctrl+Shift, press the left mouse button inside any pane, and drag it onto another pane. A subtle animated accent wash marks the source and target, and the two pane sessions exchange locations when the button is released. Dragging an inactive pane does not activate it; the currently active session remains active even when its location participates in the swap. Dropping outside another pane cancels the operation. Drag across terminal text to select it; releasing the mouse copies the selection to the system clipboard. While dragging, hold the pointer in the top or bottom text row to scroll through that pane's history; moving farther beyond the pane's text area scrolls faster. The pointer can stay still while scrolling, and the mouse wheel also extends the selection through history. Scrolling pauses when the pointer leaves the window and stops on release or loss of focus. New output preserves selections while their rows remain in history; eviction of a selected endpoint, a terminal-grid resize, reset, row-reordering control, or screen-buffer switch cancels the selection without changing the clipboard. When an application enables mouse reporting, mouse buttons and requested button/any-motion events are sent to the application instead; hold Shift while dragging to select text. Alternate-screen applications have no native scrollback, so their application-managed scrolling is unchanged. While viewing native scrollback, End returns the active pane to the live bottom, and Page Up/Page Down scroll by one screen with a one-row overlap. These keys stop any native selection drag without changing the clipboard. At the live bottom, in alternate-screen applications, or with modifiers held, the keys retain their normal shell/application behavior. Configured keybindings take precedence. Paste clipboard text with Ctrl+V, Ctrl+Shift+V, or Shift+Insert; applications that enable bracketed paste receive the standard paste delimiters. With an active mouse selection, Ctrl+C copies and clears the selection instead of sending an interrupt; without a selection it retains normal terminal interrupt behavior.

Set [panes].zoom_mode to "default" for scaled inactive previews, "none" to render every pane at the configured font size, or "zen" to place the active pane in an accent-framed viewport centered over the default previews. Press Ctrl+Shift+Z to cycle through these modes at runtime; the shortcut can be reassigned with keybindings.zoom_mode_cycle. Zen mode uses the full terminal area when no inactive panes exist. In zen mode, Ctrl+Shift+Equal/Minus changes the floating viewport percentage instead of resizing the underlying split tree, while directional pane-resize shortcuts are disabled.

Kterm automatically injects minimal prompt integration into directly launched PowerShell and zsh sessions without replacing the user's normal startup files. The prompt boundary recovers the primary screen and pane shortcuts when a foreground alternate-screen application is killed before it can restore terminal state. The zsh integration also emits OSC 7 when the prompt is displayed, allowing new splits to inherit the active pane's current local directory. Shells started from another shell, terminal multiplexers, and remote shells must provide their own integration.

OSC 52 clipboard writes are enabled by default for the active pane. This allows applications such as remote Neovim or tmux sessions to copy into the shared system clipboard. After copying, switch to any other local or SSH pane and use Kterm's normal paste shortcut; the reverse workflow is identical. Mouse selections also use the same clipboard. Configure this under [clipboard] with osc52_write and osc52_max_bytes. Clipboard queries remain unsupported, so applications cannot silently read local clipboard contents; Ctrl+V is the explicit user-authorized read path.

Use Ctrl+Shift+Equal/Minus to grow or shrink the active pane along both available dimensions. Kterm adjusts the nearest vertical and horizontal splits independently. Font zoom and all-dimension pane sizing can be reassigned under [keybindings]; bindings use physical key names and exact modifiers, and conflicting bindings are rejected at startup. Set [panes].resize_step_percent to control the percentage-point increment used by all pane resize shortcuts; it defaults to 2.

Alternate-screen applications that explicitly claim cooperative pane controls receive the H/J/K/L controls first, allowing editors such as Neovim and Kvim to navigate or resize their own splits and hand the same action to Kterm at an editor edge. Other full-screen applications leave the shortcuts with Kterm. See docs/seamless-pane-navigation.md for the cooperative protocol and Neovim setup. The native window title follows standard OSC 0/2 title updates from the active pane; titles emitted by inactive panes remain pane-local until that pane is selected. On Windows, an OSC title that is an exact executable path is replaced with the program's version-resource name. The window icon always follows the active pane's shell process. Windows and Linux use a client-rendered titlebar so the terminal's actual post-processed background continues behind its title, icon, and caption controls; native window dragging and resizing remain available through the window manager or compositor. Set window.decorations = "native" to use native decorations instead, which can be useful with tiling window managers. On macOS, the terminal background extends through the transparent native titlebar while terminal rows remain below the window controls. On Windows and Linux, ConEmu OSC 9;4 progress updates replace the custom-titlebar icon with a bounded progress indicator; indeterminate progress animates and stale progress clears after 15 seconds.

terminal.theme accepts all four Catppuccin flavors (catppuccin-latte, catppuccin-frappe, catppuccin-macchiato, and catppuccin-mocha) and all three Rosé Pine flavors (rose-pine, rose-pine-moon, and rose-pine-dawn), and six Everforest variants combining dark or light with hard, medium, or soft contrast (for example, everforest-dark-medium). Catppuccin Mocha remains the default. Each flavor supplies a coordinated terminal foreground, background, cursor, accent, surface, and 16-color ANSI palette. The Everforest colors and ANSI mapping are based on Everforest by sainnhe under the MIT license; Kterm maps its primary status-line accent to the cursor and active-pane accent. Kterm substitutes contrast-safe Everforest foreground shades for grayscale ANSI slots that upstream assigns background-layer colors, because shells and terminal applications commonly render those slots as text. See the third-party theme notices. Catppuccin Latte, Rosé Pine Dawn, and all Everforest light variants request light native window chrome. Optional foreground and background CSS-style "#RRGGBB" values in [terminal] override those two theme colors. Optional window.background independently sets the backdrop visible around pane grids and behind custom window chrome; it defaults to the effective terminal background. Background and theme changes require a restart. For temporary launches, --theme NAME overrides terminal.theme without editing the file.

Visual effects

The [effects] settings combine a full-image shader pass with accent geometry. glow_strength controls shader bloom around terminal content and overlays, while glow_radius sets its sampling distance; a zero strength disables bloom regardless of radius. Chromatic aberration offsets red and blue horizontally, scanlines darken alternating rows, vignette darkens the window edges, and noise adds per-pixel brightness variation. Setting any of those effect strengths or offsets to zero disables that effect.

Active-pane dividers and the zen pane frame have their own feathered accent halos. Their base spread and intensity are independent of glow_strength, glow_radius, and cursor_glow, although enabling shader bloom also blooms those rendered accents.

Kterm embeds the thin, thin italic, regular, italic, bold, and bold italic faces of JetBrainsMono Nerd Font Mono, so its default font works without a host font installation. It also embeds Symbols Nerd Font Mono and uses it explicitly for private-use Nerd Font glyphs, so terminal.font_family can name any installed monospace font without losing prompt icons. Run kterm --preview-fonts to browse exact family names in colored regular, thin, italic, and bold terminal cards. A scrollbar tracks the visible range; use the mouse wheel or Page Up/Down to page through the installed fonts.