Termy
Configuration

Tabs

Tab titles, tab strip behavior, and title bar.

Tab Titles

KeyDefaultDescription
tab_title_modesmartsmart | shell | explicit | static.
tab_title_prioritymanual, explicit, shell, fallbackExact source priority.
tab_title_fallbackTerminalTitle when no source available.
tab_title_explicit_prefixtermy:tab:Prefix for explicit OSC title payloads.
tab_title_shell_integrationtrueExport TERMY_* env vars for shell hooks.
tab_title_prompt_format{cwd}Template for prompt-derived titles.
tab_title_command_format{command}Template for command-derived titles.

Tab Strip

KeyDefaultDescription
tab_close_visibilityactive_hoveractive_hover | hover | always.
tab_width_modeactive_grow_stickystable | active_grow | active_grow_sticky.
tab_switch_modifier_hintstrueShow secondary+1..9 badges on first nine tabs.
vertical_tabsfalseMove tab strip into a left sidebar.
vertical_tabs_width220Width for the vertical sidebar in pixels.
vertical_tabs_minimizedfalseStart vertical tabs collapsed.
auto_hide_tabbartrueHide tab bar when only one tab is open.

Title Bar

KeyDefaultDescription
show_termy_in_titlebartrueShow or hide Termy branding in the titlebar.

On this page