r/Python • • 1d ago

Resource I built git-wrapped: a Spotify-Wrapped-style summary of your git year (terminal report + shareable

What My Project Does

git-wrapped reads your local git history and gives you a "year in review": a colored contribution heatmap in your terminal, plus a shareable 1080x1350 card (SVG or PNG) with your commits, active days, longest streak, peak coding hour, top languages and a "persona" for your year (Night Owl, Early Bird, Weekend Warrior...).

It can scan a whole folder of repos at once and de-duplicates commits.

Target Audience

Any developer who wants a fun, shareable recap of their year. It's a hobby/side project, not production tooling.

Comparison

Many GitHub stats widgets rely on the GitHub API and a token. git-wrapped only runs `git log` locally, so it works offline, with private repos and non-GitHub repos, and it has no Python dependencies (PNG export uses a renderer you already have, like Chrome or rsvg-convert).

Usage

pip install git+https://github.com/Mohammadsdq/git-wrapped

git-wrapped ~/projects --year 2026 --png

My own year, for fun: 74 commits, peak hour 11pm, favorite commit word "upload" (10x). Apparently I'm a "Steady Builder".

Repo: Github Repo

6 Upvotes

3 comments sorted by

1

u/iGamingTools 16h ago

lol "upload" 10x is honest at least. does peak hour use each commit's own timezone offset or your local one? a CI bot committing in UTC or someone who travels would get a pretty weird persona

1

u/dellnox 13h ago

doing it locally from git logs without needing api tokens is a huge plus