Settings · Deftty

Deftty works without a config file. When you want one:

~/.config/deftty/config.toml

Ghostty-style key = value lines, # comments, strings in quotes. Unknown keys are ignored. The extension is .toml, but the file is not strict TOML: a key may repeat, and [sections] are ignored.

Key	Default	Meaning
`font-family`	Monaco	Repeat the line for fallbacks, in order. An empty value resets the list
`font-size`	`13`	Points
`window-padding`	`8`	Points
`pane-info`	`"header"`	`"header"`, `"bar"` or `"off"`
`scrollback-lines`	`10000`	2000 to 50000
`claude-auto-resume`	`false`	Run the prefilled `claude --resume` on restore
`renderer`	`"metal"`	`"metal"` or `"cpu"`. Use `cpu` if the terminal renders incorrectly
`working-directory`	`"~"`	Start directory for the 일반 (General) workspace

Settings window

The settings window (⌘,) covers fonts, size, padding, scrollback, pane info and notifications. It rewrites only those keys and leaves the rest of the file alone. Reset to Defaults… removes those lines and turns notifications off, which also removes the hooks.

Fonts, size, padding, scrollback, pane info and notifications

Fonts

Role	Default
Primary	Monaco
CJK fallback	Noto Sans CJK for the system language (KR, JP, SC, TC) when installed. The Korean one downloads from Settings (33 MB, verified by SHA-256)
Icons	Symbols Nerd Font Mono, bundled

Characters missing from the primary font fall through the list in order. Example:

toml

font-family = "JetBrains Mono"
font-family = "Noto Sans CJK KR"
font-size = 14

One click in Settings downloads Noto Sans CJK KR and applies it