r/Python • u/Impossible-Ad-6925 • 18h 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