Skip to content

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ghostty Config GUI

A Python/PyQt6 graphical configuration editor for Ghostty - a fast, feature-rich, cross-platform terminal emulator.

Ghostty uses a plain text config file (~/.config/ghostty/config.ghostty). This app gives it a GUI with live previews.

Disclaimer: This project was fully vibecoded with Claude Code and barely tested. Use at your own risk. It may eat your config, misrepresent options, or spontaneously combust. PRs welcome. Tested on Ubuntu 25.10 and macOS Tahoe 26.4

Screenshots

Font options & preview Colors & theme preview
Font config Theme preview
Color Custom Color
macOS settings Linux and GTK

Features

  • 200+ config options organized into 15 categories (Font, Colors, Cursor, Window, Keyboard, Shell, Quick Terminal, macOS, Linux & GTK, etc.)
  • Theme browser — dropdown with all installed Ghostty themes, live preview with syntax-highlighted code, palette, selection colors, and cursor
  • Font preview — live sample text rendered with your selected font family and size
  • Color palette editor — visual ANSI 16-color palette with clickable swatches and color pickers
  • Terminal preview — simulated terminal showing syntax highlighting, cursor style, and fonts in real time
  • Search — filter options by name or description
  • Config file I/O — reads/writes config.ghostty, preserves comments and ordering. Only saves values you explicitly change

Quick Start

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
python3 main.py

Config File Location

By default reads/writes config.ghostty (on Linux usually ~/.config/ghostty/config.ghostty). Use File > Open to load a different file.

License

I don't care, do whatever you want, I take no responsibility for this code or how it will be used.

About

Unofficial GUI configurator for Ghostty. Fully vibecoded - it was easier to use Claude Code than read the documentation and write the configuration file ;)

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages