Skip to content

500daysofansh/github_green_graph

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎨 GitHub Contribution Graph Painter

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.

GitHub Graph Art Example

🚀 Features

  • 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.

🛠️ Prerequisites

  • Node.js (v14 or higher)
  • Python (3.x) - Only for generating text coordinates
  • Git installed and configured

📦 Installation

  1. 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
  2. Install Dependencies

    npm install

📖 Usage Guide

Step 1: Generate Your Art

Use the Python script to generate the pixel coordinates for your text.

  1. Run the generator:
    python generator.py
  2. Type your desired text (e.g., HELLO, 2025, HIRE ME).
  3. Copy the JavaScript array output (starts with const pixels = [...]).

Step 2: Configure the Painter

Open index.js and:

  1. Paste the pixel array you copied into the pixels variable.
  2. (Optional) Change the startDate to determine when the text appears on the graph.

Step 3: Paint the Graph

Run the Node.js script to generate the commits and push them to GitHub.

node index.js

About

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.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors