Skip to content

ashish0kumar/gostty

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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


© 2025-present Ashish Kumar

LICENSE  

About

👻 The iconic ghostty animation in your terminal

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Contributors 2

  •  
  •  

Languages