Skip to content
tappunkPublic

About

Live-preview Ghostty theme browser and installer

Topics

Resources

Stars

15 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

gsty

License: MIT Crates.io Version GitHub Release X Follow

gsty

Ghostty terminal theme browser with live preview TUI. Browse, filter, and apply themes with real-time palette display. A personal tool for my own workflow, not a product. Expect breaking changes and best-effort maintenance.

Installation • Usage • Theme Discovery

Features

  • Live preview — applies themes in real-time, signals running Ghostty to reload via SIGUSR2
  • TUI interface — ratatui-based terminal UI with syntax-highlighted Rust code preview
  • Dark/light filtering — toggle between all, dark, and light themes
  • Name search — filter themes by name with / search mode
  • Palette display — 16-color palette grid with background, foreground, and sample code rendering
  • Plain text listing — --list flag for non-TTY environments and scripting
  • Undo on cancel — restores the previous theme if you cancel without confirming

Installation

Homebrew

brew tap tappunk/tap
brew trust tappunk/tap
brew install tappunk/tap/gsty

Cargo

cargo install gsty

Build from source

git clone https://github.com/tappunk/gsty.git
cd gsty
cargo build --release
sudo cp target/release/gsty /usr/local/bin/gsty

Usage

gsty            # Interactive TUI theme picker
gsty --list     # Plain text listing (non-TTY fallback), alias -l
gsty --version  # Print version, alias -V
gsty --help     # Print this help, alias -h

TUI keybindings

j / Down        Move selection down
k / Up          Move selection up
g / Home        Jump to first theme
G / End         Jump to last theme
f               Cycle filter (all → dark → light)
/               Toggle search mode
Backspace       Clear search
Enter / y       Confirm selection and apply
q / Esc         Cancel, restore previous theme

Theme Discovery

gsty searches these paths for Ghostty theme files:

/Applications/Ghostty.app/Contents/Resources/ghostty/themes
/opt/homebrew/share/ghostty/themes
/usr/share/ghostty/themes
~/.config/ghostty/themes

Selected themes are applied to ~/.config/ghostty/auto/theme.ghostty. Ghostty reloads its theme automatically via the SIGUSR2 signal.

About

Live-preview Ghostty theme browser and installer

Topics

Resources

Stars

15 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages