---
title: Ghostty
description: Ghostty configuration and its herdr key sync.
---

GPU terminal emulator kept alongside kitty. Its bindings send the same herdr prefix bytes as the kitty herdr host.

| | |
| --- | --- |
| Source | `dot_config/ghostty/config`, `dot_config/ghostty/config.ghostty`, `dot_config/ghostty/themes/` |
| Target | `~/.config/ghostty/` |
| Install | Not listed in `.chezmoidata/packages.yaml`; install separately |

Ghostty reads both `config` and `config.ghostty`. `config` holds all settings; `config.ghostty` contains a single line, `theme = noctalia`, which selects the active theme.

## Options

| Option | Value |
| --- | --- |
| `font-family` / `font-size` | `Victor Mono NF` / `12.5` |
| `background-opacity` / `background-blur` | `0.9` / `true` |
| `window-decoration` | `false`; `gtk-titlebar = false` |
| `window-padding-x/y` | `12` |
| `cursor-style` | `underline`, blinking |
| `scrollback-limit` | `3023` |
| `mouse-hide-while-typing` | `true` |
| `copy-on-select` | `false` |
| `confirm-close-surface` | `false` |
| `app-notifications` | `no-clipboard-copy,no-config-reload` |
| `quit-after-last-window-closed` | `false`, delay `5m` |
| `shell-integration` | `detect`, features `cursor,sudo,title,no-cursor` |
| `gtk-single-instance` | `true` |

## Keybindings

| Key | Action |
| --- | --- |
| `cmd+c` / `cmd+v` | Copy / paste |
| `cmd+n` | New window |
| `ctrl+plus` / `ctrl+minus` / `ctrl+zero` | Font size +1 / -1 / reset |
| `shift+enter` | Sends a literal newline |
| `ctrl+shift+alt+,` | Reload config |

### herdr sync

Placed last so they override defaults. Each sends `ctrl+b` (`\x02`) followed by a key; see [herdr](/terminal/herdr).

| Key | Sends |
| --- | --- |
| `ctrl+shift+n` | `prefix %` (split vertical) |
| `ctrl+shift+t` | `prefix c` |
| `ctrl+tab` / `ctrl+shift+tab` | `prefix n` / `prefix p` |
| `ctrl+shift+f` | `prefix s` (workspace picker) |
| `ctrl+shift+l` / `ctrl+shift+h` | `prefix .` / `prefix ,` (next / previous agent) |
| `ctrl+shift+j` / `ctrl+shift+k` | `prefix j` / `prefix k` (next / previous workspace) |
| `super+enter` | `prefix N` |
| `super+r` | `prefix W` |
| `ctrl+shift+r` | `prefix T` |
| `ctrl+shift+,` | `prefix S` (herdr settings) |

## Themes

| Theme | Notes |
| --- | --- |
| `noctalia` | Active. Palette matching the Noctalia shell. |
| `ii-auto` | Auto-generated by the ii wallpaper theming system; not meant to be edited. |
| `koda-dark` / `koda-light` | Koda palettes with `bold-is-bright = true`. |