Terminal settings reference¶
All settings below belong in client.toml. Start with Terminal appearance for common changes.
Terminal config¶
Set these values under [terminal] unless an example names another table.
Colors and selection¶
[terminal]
foreground = "#abb2bf"
selection_background = "#7f6699"
selection_foreground = "none"
[terminal.background]
color = "#282c34"
alpha = 0.85
- Colors accept hex RGB/RGBA;
"none"means transparent. - Set both selection colors to
"none"for reverse-video selection. - Worlds can override appearance. See world settings.
| Setting | Controls |
|---|---|
palette |
Sixteen ANSI colors |
palette_overrides |
Individual color indices, e.g. { "17" = "#123456" } |
text_outline, text_outline_width, text_outline_color |
Text outline; width 0–32 |
Cursor¶
| Setting | Choices |
|---|---|
cursor_shape |
auto, block, bar / beam, underline, hollow |
cursor_color |
Hex color |
cursor_blink |
auto, on, off |
cursor_blink_interval_ms |
Blink interval |
cursor_beam_thickness |
Beam width |
cursor_underline_thickness |
Underline height |
Fonts and zoom¶
- Configure fonts on the server.
- Edit (
) → Fonts changes them for the current run.
- Font-size shortcuts affect the focused pane; new panes inherit the last chosen size.
- Camera zoom changes the view without changing text size or the terminal grid.
For appearance overrides under [terminal]:
| Setting | Value |
|---|---|
font_family, font_fallbacks |
Family name; ordered fallback families |
font_regular_path, font_bold_path, font_italic_path, font_bold_italic_path |
Font files |
font_size |
1–72 |
ligatures |
true / false |
line_height, column_width |
0.5–3.0 |
font_features, font_variations |
Tables keyed by four-character OpenType tags |
symbol_maps |
Unicode ranges, e.g. [{ first = 0xE000, last = 0xF8FF, family = "Symbols Nerd Font" }] |
Clipboard and links¶
These settings belong under [terminal].
| Setting | Choices or purpose |
|---|---|
clipboard_read |
deny, ask, allow for program clipboard reads |
clipboard_write |
Allow programs to write to the clipboard |
open_hyperlinks |
Enable opening links |
hyperlink_patterns |
Extra link patterns as regular expressions |
Scrolling and selection¶
| Setting | Choices or purpose |
|---|---|
scroll_multiplier |
Scroll speed, 0–100 |
selection_word_boundaries |
Characters that separate selected words |
copy_on_select |
none, primary, clipboard, both |
quick_select_patterns |
Extra Quick Select patterns |
quick_select_defaults |
Include built-in patterns |
quick_select_alphabet |
Unique lowercase letters for labels |
Bell¶
Set visual_bell_duration_ms = 0 to disable the flash; maximum 60000.
Copy mode¶
Customize word navigation using Neovim-style iskeyword rules:
- This example adds hyphens to the default word characters.
- The list replaces the defaults; include the entries you want to keep.
- Later exclusions win: add
"^_"to exclude underscores. - Space-prefixed word navigation uses fixed rules.
See copy-mode keys for navigation and selection.