https://github.com/ashish0kumar/gostty
👻 The iconic ghostty animation for your terminal
https://github.com/ashish0kumar/gostty
Last synced: 10 months ago
JSON representation
👻 The iconic ghostty animation for your terminal
- Host: GitHub
- URL: https://github.com/ashish0kumar/gostty
- Owner: ashish0kumar
- License: mit
- Created: 2025-05-26T15:27:01.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-08T07:44:23.000Z (about 1 year ago)
- Last Synced: 2025-06-17T12:19:53.189Z (12 months ago)
- Language: Go
- Homepage:
- Size: 20.9 MB
- Stars: 17
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cli-apps-in-a-csv - gostty - Animation of a ghost for the terminal. (<a name="animation"></a>Animation)
- awesome-cli-apps - gostty - Animation of a ghost for the terminal. (<a name="animation"></a>Animation)
README
gostty
The iconic ghostty.org animation in your terminal
---
## Features
- **Seamless terminal animation** inspired by [ghostty.org](https://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+](https://golang.org/doc/install)
### Install via `go install`
```bash
go install github.com/ashish0kumar/gostty@latest
```
### Build from source
Clone the repo, build the binary, and move it into your `$PATH`
```bash
git clone https://github.com/ashish0kumar/gostty.git
cd gostty
go build
sudo mv gostty /usr/local/bin/
```
Alternative (using golang docker container image)
```bash
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
```bash
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
```bash
# 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](https://ghostty.org)
- Partial reference from [SohelIslamImran/ghosttime](https://github.com/SohelIslamImran/ghosttime)
© 2025-present Ashish Kumar
 Â