gostty

The iconic ghostty.org animation in your terminal

---

Features

• Seamless terminal animation inspired by ghostty.org
• Customizable highlight colors (ANSI and named colors)
• Optional timer to run the animation for a fixed duration
• Resizes dynamically with terminal dimensions
• Animation frames embedded inside the binary for easy distribution

Installation

Prerequisites

Go 1.23.2+

Install via go install

go install github.com/ashish0kumar/gostty@latest

Build from source

Clone the repo, build the binary, and move it into your $PATH

git clone https://github.com/ashish0kumar/gostty.git
cd gostty
go build
sudo mv gostty /usr/local/bin/

Alternative (using golang docker container image)

git clone https://github.com/ashish0kumar/gostty.git
cd gostty
docker pull golang:latest
docker run --rm -ti -v ./:/go/src golang:latest bash -c "cd src; go build -buildvcs=false"
sudo mv gostty /usr/local/bin/

Usage

gostty [options]

Options

Flag	Description
-c, --color	Set highlight color (name or ANSI code)
-t, --timer	Run animation for a fixed number of seconds
--colors	Show supported colors
-h, --help	Show help

Examples

# Use cyan highlight by name
gostty -c cyan

# Use ANSI color code 36 (cyan)
gostty -c 36

# Run the animation for 10 seconds
gostty -t 10

# Show supported color options
gostty --colors

Notes

• Animation frames are embedded in the binary, so no external animation data file is required at runtime.
• Make sure your terminal supports ANSI escape codes and is large enough to render the animation (77x41 chars).

Acknowledgments

• Original ghostty animation concept from ghostty.org
• Partial reference from SohelIslamImran/ghosttime

© 2025-present Ashish Kumar