Split Pane Borders

TermSurf’s Ghostboard fork adds configuration for split pane borders on top of what Ghostty provides: you can outline split panes with colored borders and fade unfocused panes, so the active pane is always obvious. These options don’t exist in upstream Ghostty — they’re part of the fork.

Options

OptionEffect
focused-split-border-colorBorder color of the focused split. Unset (the default) draws no border. Hex (#RRGGBB or RRGGBB) or a named X11 color.
unfocused-split-border-colorBorder color of unfocused splits. Unset draws no border. Same color formats.
split-border-widthBorder width in points. 0 (the default) disables borders; values are clamped to the range 010.
unfocused-split-saturationColor saturation of unfocused splits: 1.0 is full color, 0.0 is grayscale (clamped 01). Only applies in a split layout.

Set a focused and/or unfocused border color along with a non-zero width to outline panes, and lower unfocused-split-saturation to visually push inactive panes back.

# ~/.config/termsurf/config
focused-split-border-color = #7aa2f7
unfocused-split-border-color = #3b4261
split-border-width = 2
unfocused-split-saturation = 0.6

For the authoritative, generated text of each option, see the config reference (for example,

split-border-width

), and the configuration guide for where the config file lives. These split-border options sit alongside the terminal features TermSurf inherits from Ghostty — see Features.