Skip to main content

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.

Installs Latest release macOS and Linux MIT licence Listed on The Terminal Index

The wall of themes

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

Window settings
212 settings, grouped in cards with a live preview, every value explained, and the exact line that will be written.
Input settings
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
Programs that put Ghostty to use: prompts and completions, images in the terminal (Kitty graphics), clickable links (OSC 8), system monitors, editors, sessions.
Font downloads
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 layout
Palette: one search line over themes, fonts, settings, shortcuts and commands.
Guided layout
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-config over D-Bus (needs gdbus and 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)

Table of built distributions (wheels) for ghostty-config 2.5.0
File Actions
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 musl 1.1+ x86-64, Linux glibc 2.17+ 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 musl 1.1+ ARM64, Linux glibc 2.17+ 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 log

Release 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 log

Release 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 log

Release 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 log

Security 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.

Select from 4 files

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 log

A 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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page