Inspired by GitHub Painter by @mattrltrent
Create custom contribution patterns on your GitHub profile with this interactive tool.
Contribution Painter is a tool that allows you to design a custom contribution graph that appears on your GitHub profile. This project was created as a learning exercise, heavily inspired by the original GitHub Painter by Matthew Trent.
While this version was written from scratch with different code, much of the UI layout and core functionality is similar to the original. I acknowledge and appreciate the inspiration and apologize for not crediting it earlier.
- Interactive contribution calendar to draw your pattern
- Supports multiple years of contribution history
- Multiple intensity levels for detailed designs
- Keyboard shortcuts for faster drawing
- Generates a bash script to implement your design
- Visit the Contribution Painter website
- Enter your GitHub repository URL (e.g.,
https://github.com/YOUR_USER/YOUR_REPO) - Select the year you want to use
- Draw on the grid using click & drag
- Click
"Download script →" - In your terminal, navigate to the download directory
- Run
chmod +x github_painter.sh && ./github_painter.sh
- Space: Empty cell (level 0)
- A: Light contribution (level 1)
- S: Medium contribution (level 2)
- D: Strong contribution (level 3)
- F: Maximum contribution (level 4)
- Esc: Clear board
- The script pushes commits to the specified repository — use a throwaway repo, not a production one
- Commits should appear in your contribution graph a few minutes after pushing
Visit my GitHub profile to see the kinds of patterns you can make.
Bug reports or feature suggestions are welcome — open an issue or submit a PR.
This version is for educational and non-commercial use. The original GitHub Painter had no license at the time this was created, and I now acknowledge that means it should not have been reimplemented or distributed without permission. Going forward, I am open to removing or significantly modifying this repo if the original author requests it.
This project was created purely for educational purposes, to learn from an inspiring tool. Please use responsibly and respect GitHub’s contribution graph system.