ghostty-config

# Ghostty Configuration

Ghostty is a modern terminal emulator. Configuration lives in `$HOME/.config/ghostty/config`.

## Config Syntax

```
# Key-value pairs separated by equals signs
font-family = Iosevka
font-size = 14

# Spacing around = doesn't matter
key=value
key = value

# Lines starting with # are comments
# Comments cannot be inline (would be part of value)
background = #282c34

# Empty value resets to default
key =

# Repeatable options (keybind, palette, font-family fallbacks)
keybind = ctrl+shift+c=copy_to_clipboard
keybind = ctrl+shift+v=paste_from_clipboard
```

## Common Configuration Options

| Option | Default | Description |
|--------|---------|-------------|
| `font-family` | (system) | Primary font, repeatable for fallbacks |
| `font-size` | 13 | Font size in points |
| `theme` | (none) | Color theme name |
| `background` | #282c34 | Background color |
| `foreground` | #ffffff | Foreground color |
| `background-opacity` | 1 | Window transparency (0-1) |
| `cursor-style` | block | `block`, `bar`, `underline` |
| `scrollback-limit` | 10000000 | Scrollback buffer lines |
| `window-padding-x` | (none) | Horizontal padding in pixels |
| `window-padding-y` | (none) | Vertical padding in pixels |
| `keybind` | (defaults) | Custom keybinding (repeatable) |

### macOS-Specific Options

| Option | Default | Description |
|--------|---------|-------------|
| `macos-option-as-alt` | (none) | Use Option as Alt: `left`, `right`, `true` |
| `macos-titlebar-style` | transparent | `transparent`, `native`, `tabs` |
| `macos-non-native-fullscreen` | false | Use non-native fullscreen |

### Linux-Specific Options

| Option | Default | Description |
|--------|---------|-------------|
| `gtk-titlebar` | true | Show GTK titlebar |
| `gtk-tabs-location` | top | Tab bar location |

## Keybindings

Format: `keybind = <trigger>=<action>`

### Triggers
- Modifiers: `ctrl`, `alt`, `shift`, `super` (Cmd on macOS)
- Combine with `+`: `ctrl+shift+c`
- Key names: `a-z`, `0-9`,