A creative automation tool that turns your GitHub contribution graph into a canvas. Write text, draw patterns, or fill gaps in your activity history by programmatically generating commits with past timestamps.
- Text-to-Pixels: Includes a Python helper that converts any text (A-Z, 0-9) into coordinate arrays.
- Custom Dates: Specify exactly when the art should start (e.g., "start from July 2025").
- Intensity Control: Automatically generates multiple commits per pixel to ensure squares are "Dark Green."
- Instant Undo: Instructions included on how to clean up the graph if you make a mistake.
- Node.js (v14 or higher)
- Python (3.x) - Only for generating text coordinates
- Git installed and configured
-
Clone the repository
git clone [https://github.com/your-username/github-graph-painter.git](https://github.com/your-username/github-graph-painter.git) cd github-graph-painter -
Install Dependencies
npm install
Use the Python script to generate the pixel coordinates for your text.
- Run the generator:
python generator.py
- Type your desired text (e.g.,
HELLO,2025,HIRE ME). - Copy the JavaScript array output (starts with
const pixels = [...]).
Open index.js and:
- Paste the pixel array you copied into the
pixelsvariable. - (Optional) Change the
startDateto determine when the text appears on the graph.
Run the Node.js script to generate the commits and push them to GitHub.
node index.js