gitcredits

README

gitcredits

Git log doesn't do them justice. Turn your contributors into movie stars.

Install

Quick install (recommended)

curl -sL https://raw.githubusercontent.com/Higangssh/gitcredits/main/install.sh | sh

Supports macOS (Intel/Apple Silicon), Linux (x86_64/ARM64), and Windows (x86_64 via Git Bash).

Pre-built binaries

Download the latest release for your platform from GitHub Releases.

Go

go install github.com/Higangssh/gitcredits@latest

From source

git clone https://github.com/Higangssh/gitcredits.git
cd gitcredits
go build -o gitcredits .

Usage

cd your-repo
gitcredits

# or target another repository directly
gitcredits /path/to/your-repo

That's it. Run gitcredits inside a Git repository, or pass a target repository path directly.

Themes

Matrix — digital rain with text resolve effect:

gitcredits --theme matrix

Spider-Man — glitch effects with radial web transitions:

gitcredits --theme spiderman

Export to GIF

Save the credits as a high-quality GIF — perfect for READMEs, presentations, or sharing.

gitcredits --output credits.gif
gitcredits --output credits.gif --theme matrix
gitcredits --output credits.gif --theme spiderman
gitcredits /path/to/your-repo --output credits.gif

Requires VHS and ffmpeg:

brew install vhs ffmpeg

VHS records the terminal in real-time, and ffmpeg converts it to an optimized GIF with 2-pass palette generation for maximum quality.

Controls

Key	Action
↑ / ↓	Manual scroll
q / Esc	Quit

What it shows

• ASCII art title from your repo name
• Project lead — top contributor by commits
• Contributors — everyone who committed
• Notable scenes — recent feat: and fix: commits
• Stats — total commits, contributors, GitHub stars, language, license

GitHub metadata (stars, description, license) requires gh CLI to be installed and authenticated. Works without it — you'll just get git-only data.

Requirements

• git (required) — commit history, contributors, repo info
• Go 1.21+ — for go install
• gh CLI (optional) — enables GitHub stars, license, language, and description
• VHS + ffmpeg (optional) — required for --output GIF export

License

MIT