Skip to content

tappunk/gsty

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.

InstallationUsageTheme 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 install tappunk/gsty/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)

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

Ghostty terminal theme browser with live preview TUI. Filters by dark or light, searches by name, signals Ghostty to reload on apply.

Topics

Resources

Stars

Watchers

Forks

Releases

Contributors

Languages