Windows-Only Options

Wintty adds configuration options that have no counterpart in upstream Ghostty. They are read by the Windows application rather than by libghostty, so they do not appear in the Option Reference, which is generated from the Zig configuration schema.

They are set the same way as any other option, in the same configuration file:

background-style = frosted
vertical-tabs = true
log-level = debug

Note

Because these keys are unknown to libghostty, older versions of Wintty reported them as "unknown field" errors. Current versions recognise them and surface them as informational instead.

Option	Purpose
background-style	Backdrop material preset (solid/frosted/crystal).
background-tint-color	Tint color overlaid on the acrylic backdrop.
background-tint-opacity	Strength of the acrylic tint color.
background-luminosity-opacity	Strength of the acrylic luminosity layer.
background-blur-follows-opacity	Reduce blur radius as background-opacity increases.
accent-color	Color of the active tab background, focus border, and tab strip rail. When unset, the chrome follows cursor-color.

Option	Purpose
background-gradient-point	Position/color/radius of a radial gradient source (repeatable).
background-gradient-animation	Motion preset applied to gradient points.
background-gradient-speed	Animation speed multiplier for gradient motion.
background-gradient-blend	Whether the gradient renders over or under terminal text.
background-gradient-opacity	Strength of the gradient tint layer.

Option	Purpose
vertical-tabs	Tab strip orientation. When true, tabs render in a vertical sidebar instead of the default horizontal strip.
command-palette-group-commands	Group entries in the command palette by category instead of listing them flat.
command-palette-background	Backdrop material for the command palette (acrylic / mica / opaque).

Option	Purpose
default-profile	Id of the profile opened for a new tab or window when none is specified.
profile-order	Comma-separated list of profile ids defining the order shown in the tab picker and command palette.

Option	Purpose
windows-single-instance	When true, a second launch is routed into the already-running instance (opens a new window) instead of starting a separate process.
windows-high-contrast	When true (default), the terminal surface follows the Windows High Contrast theme automatically; set false to keep your configured colors even in High Contrast mode.
power-saver-mode	How the app reacts to Windows power-saving signals (auto, always, never).
quick-terminal-key	Global hotkey chord that toggles the quick terminal (default ctrl+backquote). Unparseable values fall back to the default chord.
no-color-override	How Wintty reacts to a NO_COLOR value inherited from the environment: notify (default -- honor NO_COLOR but show a one-time notice offering to enable color), strip (enable color by removing NO_COLOR from spawned shells), or keep (honor NO_COLOR silently).

Option	Purpose
log-level	Minimum severity written to the app log: trace, debug, info (default), warn, error, or off. An unrecognized value falls back to info silently.
log-filter	Comma-separated CATEGORY=LEVEL pairs overriding log-level per component (longest matching category prefix wins). Malformed pairs and unknown levels are skipped silently.