Overview

Settings Reference

Window size and position apply to new windows only. Existing windows keep their geometry.

Sections#

Theme

The GhosttyTheme catalog, grouped into Light and Dark. Defaults are GitHub Light Default and GitHub Dark Default.

The selected theme also drives the window and tab bar background, and the app's overall appearance, so the chrome matches the terminal instead of floating separately. More in Themes.

Font
  • Family — System, or any monospace font JusTTY detects on your machine
  • Size — 8 to 32 px, default 13
  • Line height — 0.8× to 2.0×
  • Weight — Regular, Medium, Semibold, Bold

See Fonts and Zoom for how these interact with per-tab ⌘+ zoom.

Window
  • Confirm before closing tabs with a running command — on by default
  • Padding — 0 to 64 px around the terminal surface
  • Starting position — X and Y from the top-left of the main screen, clamped to the visible frame
  • Size as character grid — columns 20 to 500, rows 5 to 200, default 80×24

Sizing by character grid rather than pixels means an 80×24 window is exactly 80×24 regardless of your font size.

Keyboard Shortcuts

Opens a read-only sheet listing every binding. It is the same catalog documented in Keyboard Shortcuts; nothing here is editable.

Configuration

Open Configuration… opens config.yml in your default text editor, Ghostty-style. Editing by hand is supported; see config.yml for the reload step.

What is not in Settings#

Scrollback size, cursor style, clipboard permissions, and the rest are host-owned. They are listed in Fixed Ghostty Behavior.

Updated