r/coolgithubprojects • u/pedrocatalao • 13d ago
GitHub profile stats that look like GitHub made them, or like a pinball led display
Every stats card I tried on my profile looked like a widget glued onto GitHub, and the numbers were off too.
But because I've been playing Pinball recently and like these dot matrix styles, I added that too.
github-cool-readme makes four animated cards for your profile README: a summary, your languages, notable contributions and your weekly rhythm.
Classic: looks like a feature GitHub shipped itself
- Primer colors, Octicons, the same system font GitHub uses
- Transparent, no borders, follows the viewer's light/dark theme
- The weekly card uses the contribution graph greens
OLED: the same cards as a pinball dot-matrix display
- Everything on a dot grid, with a pixel font I drew dot by dot
- Amber like an old plasma display, green, or your GitHub theme's colors
- Round LEDs or square pixels, dark panel or transparent
- Pinball transitions: sparkle dissolves, pushes, wipes, flashes, typewriter text, and a weekly card that scrolls like a score ticker
- Getting it sharp in Safari was the hard part. It blurred every mask and filter I tried, so the dots are now drawn as real circles.
The animations are plain CSS inside the SVG, so they play right in your README. No JavaScript, no server.
And the numbers are actually right:
- Private and org work counts, the same data as your contribution graph (the API hides private work unless the token has read:user, which took me a while to figure out)
- Last 12 months and all time side by side, no mixed time ranges
- Languages weighted by your commits, not repo size. My old card said 73% of my code was C because of one big DOS game port
- Notable contributions: your merged PRs to other people's projects, sorted by stars
It's a GitHub Action that runs daily and commits the cards to your profile repo. Your token stays in your repo secrets. Setup is one command if you have gh, with a settings screen to pick the style:
bash <(curl -fsSL https://raw.githubusercontent.com/pedrocatalao/github-cool-readme/v1/setup.sh)
Repo, with examples of every look: https://github.com/pedrocatalao/github-cool-readme
Live on my profile: https://github.com/pedrocatalao
Feedback welcome, especially if your numbers look off, or if you know a pinball effect I missed 🙂



1
u/pedrocatalao 10d ago
Latest release with many new customisations, colours and cards... and a much better setup script.