❯_termy
Getting started

Config file

Where settings live and how to edit them.

PlatformPath
macOS / Linux~/.config/termy/config.txt
Windows%APPDATA%\termy\config.txt

Open Settings (Cmd , / Ctrl ,) or edit the file directly. Each line is key = value. Comments start with #.

theme = termy
font_family = JetBrains Mono
font_size = 14
shell = /opt/homebrew/bin/fish
keybind = cmd-p=toggle_command_palette

Termy does not bundle custom fonts. A font_family value must name a family installed on your system; if it is missing or not fixed-pitch, Termy shows a warning and falls back to an installed monospace font (preferring Consolas on Windows, Menlo on macOS, or your Fontconfig monospace preference on Linux). On Linux, font_family = monospace follows that system preference and resolves it to a concrete font before rendering. On Windows, if an installed font is still not found, try reinstalling it for all users rather than only your account.

Colors

Only [colors] uses a section header:

[colors]
foreground = #e7ebf5
background = #0b1020

Tasks

task.build.command     = cargo build
task.build.working_dir = crates/cli

Common tweaks

GoalSetting
Transparent windowbackground_opacity = 0.88
Blurbackground_blur = true
Always show tab barauto_hide_tabbar = false

Full key list: Configuration reference. Keybind syntax: Keybindings.

On this page