Fonts
▼The font family to use. Use ghostty +list-fonts to see available fonts.
Can specify multiple fonts separated by commas for fallbacks
Font size in points. Supports decimals for high DPI displays.
Draw fonts with a thicker stroke (macOS only).
Control whether Ghostty synthesizes bold/italic if not available in font.
Font features to enable/disable (e.g., ligatures). Use -calt to disable ligatures.
Font family for bold text. Override if your font has a dedicated bold variant.
Font family for italic text.
Font family for bold italic text.
Named font style (e.g., "Regular", "Medium") if your font doesn't use weight-based naming.
Named style for bold text.
Named style for italic text.
Named style for bold italic text.
Colors & Theme
▼Theme name or path. Use ghostty +list-themes to see available themes.
For light/dark auto-switching: light:ThemeName,dark:ThemeName
Background color (overrides theme).
Foreground/text color (overrides theme).
Text color when selected.
Background color of selected text.
Minimum contrast ratio (1-21) between foreground and background. Higher values prevent hard-to-read text.
Use bright colors for bold text (terminal convention).
Invert foreground/background for selection instead of using selection colors.
Invert foreground/background colors under cursor.
Color Palette (ANSI Colors)
▼Customize the 16 ANSI colors used by terminal applications. These override theme colors.
Cursor
▼The default cursor style. Programs can override this.
Whether the cursor blinks by default.
Cursor color. Can also be cell-foreground or cell-background.
Color of text under the cursor.
Cursor opacity (0.0 to 1.0).
Background Effects
▼Window background opacity (0.0 = transparent, 1.0 = opaque).
Blur the background when opacity is less than 1. Can be true/false or a number (blur intensity).
Path to a PNG or JPEG background image.
Background image opacity (relative to background-opacity).
How the background image is scaled.
Window
▼Horizontal padding in points. Can be single value or "left,right".
Vertical padding in points. Can be single value or "top,bottom".
Automatically balance padding to center the grid.
Window decoration style.
Theme for window decorations.
Initial window height in grid cells.
Initial window width in grid cells.
Start windows in fullscreen mode.
Color of the window padding area.
Synchronize rendering with monitor refresh. Disable for lower latency.
When to show resize overlay with dimensions.
Position of the resize overlay.
Duration to show resize overlay (in milliseconds). Set to 0 to disable timeout.
Use formats like 750ms, 1s, or just a number for milliseconds
Show confirmation dialog when closing window with running process.
Save window state (size, position) on exit.
Font family for window title (if using integrated title bar).
Mouse & Input
▼Hide mouse cursor while typing.
Scroll speed multiplier (lines per tick).
Mouse hovering over a split focuses it.
Interval for detecting multi-click (double, triple) in milliseconds.
Allow shift+click to extend selection even in mouse capture mode.
Clipboard
▼Allow programs to read clipboard (OSC 52).
Allow programs to write to clipboard (OSC 52).
Automatically copy selected text to clipboard.
Remove trailing spaces when copying.
Warn before pasting content that could be dangerous (multiline commands, etc).
Use bracketed paste when safe (shell integration detected).
Shell & Command
▼Command to run (usually a shell).
Shell integration mode for enhanced features.
Scrollback buffer size in bytes.
Command to run before starting shell (e.g., tmux attach).
Initial working directory for new terminals.
Use 'inherit' to use parent directory, or specify a path
Keep terminal open after command exits (useful for viewing output).
Minimum runtime before considering command exit abnormal.
Control which shell integration features are enabled.
Features: cursor, sudo, title. Use no-feature to disable (e.g., no-cursor)
Allow programs to send desktop notifications (OSC 777).
Value for TERM environment variable.
Use xterm-256color if apps don't support xterm-ghostty
Keybindings
▼Build custom keybindings visually or enter them manually below.
Or enter keybindings manually (one per line):
macOS Settings
▼Style of the macOS titlebar.
Treat Option key as Alt for terminal programs.
Customize the dock icon.
Add frame around custom icons.
Custom color for the ghost icon.
Custom color for the screen background on icon.
Show folder icon in titlebar (proxy icon).
Enable window shadow.
Automatically enable secure keyboard input when password prompts detected.
Show visual indicator when secure keyboard input is active.
Linux/GTK Settings
▼Tab bar location.
Run as single instance.
Use wide tabs that fill the tab bar.
Use libadwaita styling.
Show GTK header bar/titlebar.
Quick Terminal
▼Where the quick terminal appears.
Size of quick terminal.
Which screen to show quick terminal on.
Animation duration for quick terminal show/hide.
In milliseconds. Set to 0 to disable animation.
Auto-hide quick terminal when focus lost.