ghostty-config
Themes, fonts, shortcuts and every everyday setting of Ghostty, in a full-screen interface inside the terminal.
A single binary, installed with one command.
Install
curl -fsSL https://ghostty-config.vitruves.workers.dev/install.sh | sh
Or with pip (pipx and uv work too): pip install ghostty-config.
The script puts a checksum-verified binary for your system (macOS or Linux, Intel or ARM) in ~/.local/bin. No Go, no git, no dependencies. From source: git clone https://github.com/vitruves/ghostty-config.git && cd ghostty-config && make build && make local-install.
Use
Run ghostty-config. Browsing changes nothing: a theme or a font is written when you press Enter on it, a setting when you change its value.
Layouts
The same settings, three ways to reach them. A chooser asks for one at first launch; switch any time with F4 or in Tool → Interface → Layout.
- Atelier: sections in a sidebar, the wall of themes, every setting in its place (the screenshots above and below).
- Palette: one search line over themes, fonts, settings, shortcuts and commands, with filters. The highlighted setting opens in place; a theme previews in a strip drawn in its colours.
- Guided: six plain questions, one page at a time (Colours, Font, Window, Cursor, Copy & paste, Done), with large previews and a link to all the settings of each step.
Keys
The keys of Atelier; Palette and Guided show theirs in the footer.
| Key | Action |
|---|---|
Tab |
Next section |
↑ ↓ |
Move through the list |
← → |
Change the highlighted setting |
Enter |
Apply, or open the full list of values |
Delete |
Back to Ghostty's default |
Ctrl+Z |
Undo the last change |
/ or type |
Search themes, settings and commands |
Ctrl+T Ctrl+F |
Try a theme in this terminal; star it |
F3 |
Ghostty's own documentation of the highlighted line (Ghostty 1.4) |
F4 |
ghostty-config's own settings: layout, look, reload, update check, drawing |
F1 Esc |
Help; go back, then quit |
Everything can be clicked too: sections, pills, switches, sliders, and a double click on a theme card applies it.
Sections
- Themes: 1071 themes, the 252 of the curated collection in 27 families and the 819 Ghostty 1.4 ships, plus your own, each shown as a card and checked for contrast. Create, edit and save your own.
- Fonts: family, style and size with a specimen set in the font itself, spacing, ligatures, the OpenType features and variable axes the font really has, Nerd Font icons. 70 monospace families can be downloaded in one Enter, and if your font is missing or proportional the tool offers one.
- Window: title bar, opacity, blur, padding, background image, size and position at launch, with a preview.
- Input: cursor, clipboard, mouse, and every keyboard shortcut: press the new one, conflicts are shown.
- Session: scrollback, window restore, quick terminal, bell, notifications, shell integration.
- Extensions: shaders and theme packs, with their source and licence shown before install.
- Tool: reload Ghostty, check the config, see the session's changes, restore a backup, the interface's own layout and look: its scheme, accent colour and contrast, and when drawn as images its size and the width of theme cards.
Settings follow the Ghostty you have: 1.4's new ones (scrollback in bytes, clipboard access and limits, link-osc8, the SSH terminfo cache…) are offered to 1.4, and 1.3 keeps working. See CHANGELOG.md for what changed in each version.
Good to know
- Your files. Each setting is rewritten on its own line and comments are kept. If a file changed elsewhere meanwhile, your edits there are kept too. Every file is backed up to
~/.config/ghostty-config/backups/before its first change. - Checked. After each write the config goes through
ghostty +validate-config, and any problem is shown with its line. - Reload. On macOS with Ghostty 1.3 or later the tool asks Ghostty to reload over AppleScript (macOS asks once, under Privacy & Security → Automation); older versions get the reload shortcut instead (needs the Accessibility permission). On Linux it activates Ghostty's
reload-configaction over D-Bus, which needsgdbusand a single-instance Ghostty; otherwise, reload Ghostty yourself. - Display. In Ghostty and Kitty the interface is drawn as images (Kitty graphics protocol), elsewhere and in tmux with plain text.
- Updates. At most once an hour, a background check on GitHub offers new releases. Nothing else uses the network except downloads you ask for.
Options
-config file edit this file instead of the default config
-themes dir user themes directory
-cells draw the interface with terminal text, keeping images for theme cards
-no-images never draw images
-images draw images even where the terminal is not known to support them
-plain use only characters every terminal can draw
-no-reload never ask Ghostty to reload
-no-update-check never check GitHub for a new release
-export-collection dir write the curated themes to a directory and exit
-paths print the files that are read and written
-version print the version
-cells, -no-images, -images, -plain, -no-reload and -no-update-check hold for one launch. To keep a choice for every launch, set it in F4 (Drawing, Simple glyphs, Reload Ghostty after each change, Check for updates); a flag given on the command line overrides the saved preference, and F4 shows that row as set by the flag.
Credits
Ghostty is by Mitchell Hashimoto and its contributors. Shaders come from KroneCorylus/ghostty-shader-playground and 0xhckr/ghostty-shaders. The interface is set in Google Sans Flex and Google Sans Code (SIL OFL). MIT licence.
Metadata
Release files for ghostty-config 2.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Actions Reset | |||
|---|---|---|---|---|
| ghostty_config-2.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64, Linux musl 1.1+ x86-64 | Details for ghostty_config-2.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl |
| ghostty_config-2.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl | Python 3 | none | Linux musl 1.1+ ARM64, Linux glibc 2.17+ ARM64 | Details for ghostty_config-2.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl |
| ghostty_config-2.1.0-py3-none-macosx_12_0_x86_64.whl | Python 3 | none | macOS 12.0+ x86-64 | Details for ghostty_config-2.1.0-py3-none-macosx_12_0_x86_64.whl |
| ghostty_config-2.1.0-py3-none-macosx_12_0_arm64.whl | Python 3 | none | macOS 12.0+ ARM64 | Details for ghostty_config-2.1.0-py3-none-macosx_12_0_arm64.whl |
Total release size: 18.0 MB
Release files / ghostty_config-2.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
| Download URL | ghostty_config-2.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl |
|---|---|
| Size | 4.7 MB |
| Tags | Linux glibc 2.17+ x86-64 Linux musl 1.1+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
9763095a131a0a5fcb04ca59e798590032ba88a759ce26614c170cd036db1dcf
|
|
BLAKE2b-256 checksum How to use checksums |
ba44607894fd63ed903fcb1f82b534e2818b5e779717d45f5fa07ba8789c5609
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logRelease files / ghostty_config-2.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
| Download URL | ghostty_config-2.1.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl |
|---|---|
| Size | 4.2 MB |
| Tags | Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
ca00b0077a2aa35bdaea54b9b64c4cfb7b2d7854c8b1db2a39e20247b6da4de2
|
|
BLAKE2b-256 checksum How to use checksums |
2e8e6eb4d452c24ad50dd8e4a4d96b0dd6525dacd83a4577e87fbc66ca22c36d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logRelease files / ghostty_config-2.1.0-py3-none-macosx_12_0_x86_64.whl
| Download URL | ghostty_config-2.1.0-py3-none-macosx_12_0_x86_64.whl |
|---|---|
| Size | 4.7 MB |
| Tags | Python 3 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
3d64e1b423c63ecccb023c6edd558dbde23bec9aa9fd1ccf3ea1f2f2271dbce1
|
|
BLAKE2b-256 checksum How to use checksums |
2900f4a5c283166d4ed2eabc3aec337524453fa9f05a39a180b8a73337b2663e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logRelease files / ghostty_config-2.1.0-py3-none-macosx_12_0_arm64.whl
| Download URL | ghostty_config-2.1.0-py3-none-macosx_12_0_arm64.whl |
|---|---|
| Size | 4.3 MB |
| Tags | Python 3 macOS 12.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ab774f504c007ed8829103d5c618dbb7751bade74698ceea55ddbc80aafbb371
|
|
BLAKE2b-256 checksum How to use checksums |
52e3d3e093023dfb397bf67ab16edcd0010f1be2ca925bc7ff214ddc6812d479
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logSecurity for ghostty-config 2.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 4 files in this release have been uploaded with provenance metadata.
Attestation for ghostty_config-2.1.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.