ghostty-config
Themes, fonts, programs and every setting of Ghostty, in a full-screen interface inside the terminal.
One binary, one command to install. Website.
Install
curl -fsSL https://ghostty-config.vitruves.workers.dev/install.sh | sh
or pip install ghostty-config (pipx and uv work too). Then run ghostty-config. Browsing changes nothing: a theme or a font is written when you press Enter, a setting when you change its value.
From source
Needs Go 1.26 or later.
git clone https://github.com/vitruves/ghostty-config.git
cd ghostty-config
make build # builds build/ghostty-config
make local-install # copies it to ~/.local/bin, no sudo
make install puts it in /usr/local/bin instead (asks for sudo). Or, with Go alone: go install github.com/vitruves/ghostty-config/cmd/ghostty-config@latest.
Everything in one place
212 settings, grouped in cards with a live preview, every value explained, and the exact line that will be written. |
Cursor, mouse, clipboard, shortcuts: press a new shortcut, conflicts are shown. Light or dark, any accent colour. |
Download from inside, in one Enter
| 1071 themes | the 252 of the curated collection in 27 families, the 819 Ghostty ships, and 5 packs (cyberdream, onedarkpro, nightfly, vscode, oasis) |
| 70 fonts | the whole Nerd Fonts release, Google Sans Code, Maple Mono, JuliaMono, installed without admin rights |
| 37 programs | zellij, yazi, starship, zoxide, fzf, atuin, lazygit, btop, neovim, helix… started with your shell |
| 16 shaders | cursor trails (smear, blaze, warp, sweep…) and screen effects (bloom, CRT, VHS, starfield, black hole) |
Programs that put Ghostty to use: prompts and completions, images in the terminal (Kitty graphics), clickable links (OSC 8), system monitors, editors, sessions. |
Fonts you have, then the ones to download, with the Nerd Font icons included. The specimen is set in the font itself. |
The 37 programs, and how they are installed
- Shell: starship, zoxide, fzf, atuin, carapace, lig
- Images: yazi, superfile, presenterm, fastfetch, kitten icat, chafa, viu, tdf (PDFs)
- Links: ripgrep, eza, fd, delta
- Tools: bat, glow, lazygit
- System: btop, bottom, dust, duf, procs, hyperfine
- Search: television, jq, fx, tealdeer, navi
- Editors: neovim, helix, micro
- Sessions: zmx, zellij
From Homebrew when you have it, else from the project's GitHub release into ~/.local/bin, checked against the SHA-256 GitHub gives; never as root. The line that starts it goes in one marked block of ~/.zshrc, ~/.bashrc (~/.bash_profile on macOS) or conf.d/ghostty-config.fish, backed up before its first change. Switching a program off takes its line out; Ctrl+X uninstalls it after a yes. A line of your own, or a program installed some other way (apt, cargo…), is left alone.
Three layouts
Palette: one search line over themes, fonts, settings, shortcuts and commands. |
Guided: six plain questions, one page at a time, with large previews. |
Atelier, the sections and the wall of themes above, is the third. A chooser asks at first launch; switch any time with F4.
Keys
| 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, the menu of a long value, and a double click on a theme card applies it. Sliders are pulled: the preview follows the pointer and the value is written when you let go. Palette and Guided show their keys in the footer.
Good to know
- Your files. Each setting is rewritten on its own line and comments are kept. 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 (needs the Accessibility permission). On Linux it activates
reload-configover D-Bus (needsgdbusand a single-instance Ghostty). - Ghostty 1.3 and 1.4. 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. The few options that are lists of lines (env,key-remap…) stay in the file. - Display. In Ghostty and Kitty the interface is drawn as images (Kitty graphics protocol), elsewhere and in tmux with plain text.
- Network. At most once an hour, a background check on GitHub offers new releases. Nothing else uses the network except downloads you ask for.
- The install script puts a checksum-verified binary in
~/.local/bin, for macOS or Linux, Intel or ARM. No Go, no git, no dependencies.
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
The display and reload flags hold for one launch; F4 keeps a choice for every launch, and a flag overrides it.
See CHANGELOG.md for what changed in each version.
Credits
Ghostty is by Mitchell Hashimoto and its contributors. Shaders come from KroneCorylus/ghostty-shader-playground, hackrdotsh/ghostty-shaders, sahaj-b/cursor-shaders, hced/ghostty-cursor-trails and s0xDk/ghostty-blackhole; fonts, programs and theme packs from the projects named in the interface. The interface is set in Google Sans Flex and Google Sans Code (SIL OFL). MIT licence.
Metadata
Release files for ghostty-config 2.5.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.5.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.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl |
| ghostty_config-2.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64, Linux musl 1.1+ ARM64 | Details for ghostty_config-2.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl |
| ghostty_config-2.5.0-py3-none-macosx_12_0_x86_64.whl | Python 3 | none | macOS 12.0+ x86-64 | Details for ghostty_config-2.5.0-py3-none-macosx_12_0_x86_64.whl |
| ghostty_config-2.5.0-py3-none-macosx_12_0_arm64.whl | Python 3 | none | macOS 12.0+ ARM64 | Details for ghostty_config-2.5.0-py3-none-macosx_12_0_arm64.whl |
Total release size: 18.5 MB
Release files / ghostty_config-2.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl
| Download URL | ghostty_config-2.5.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.musllinux_1_1_x86_64.whl |
|---|---|
| Size | 4.8 MB |
| Tags | Linux glibc 2.17+ x86-64 Linux musl 1.1+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
576c4f32caf9a450a2d295cbf406c5e187b2a9ae0309c77e2cd561008718db87
|
|
BLAKE2b-256 checksum How to use checksums |
a2be6925e5e1a6587cad88c4f5380c440a2792428e2662b9e9165264cd7d18df
|
| 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 20, 2026.
Transparency logRelease files / ghostty_config-2.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl
| Download URL | ghostty_config-2.5.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.musllinux_1_1_aarch64.whl |
|---|---|
| Size | 4.3 MB |
| Tags | Linux glibc 2.17+ ARM64 Linux musl 1.1+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
e5fa575c5f3fc28d05ff557357dafe3cea72e3966a406b905711aedc8bf8234d
|
|
BLAKE2b-256 checksum How to use checksums |
db7e0e888514b47ca69242a1947e34058e0547335ff8e2292876b1d36de88038
|
| 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 20, 2026.
Transparency logRelease files / ghostty_config-2.5.0-py3-none-macosx_12_0_x86_64.whl
| Download URL | ghostty_config-2.5.0-py3-none-macosx_12_0_x86_64.whl |
|---|---|
| Size | 4.9 MB |
| Tags | Python 3 macOS 12.0+ x86-64 |
|
SHA-256 checksum How to use checksums |
c60138c4408166305a84bfe117253039f15347f80c1d0943711be91c2eeb8ea9
|
|
BLAKE2b-256 checksum How to use checksums |
c4a2f3002266e4ddb98cb566f8874ba01704e6b743ac781718d8cb2281a5b505
|
| 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 20, 2026.
Transparency logRelease files / ghostty_config-2.5.0-py3-none-macosx_12_0_arm64.whl
| Download URL | ghostty_config-2.5.0-py3-none-macosx_12_0_arm64.whl |
|---|---|
| Size | 4.5 MB |
| Tags | Python 3 macOS 12.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
b37b34770942aa2ae4cb80ac9679a0b35bb13fb9ed94220aad1a172edb98bc72
|
|
BLAKE2b-256 checksum How to use checksums |
2243f679ae9555e06d161f6fc1e4f73426ac71f5aeca638fad5d4099b7e03df0
|
| 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 20, 2026.
Transparency logSecurity for ghostty-config 2.5.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.5.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 20, 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.