Skip to content
/ RepGreen Public

A Python-based tool to automate and customize your GitHub Contribution Graph using GitHub Actions.

License

Notifications You must be signed in to change notification settings

N1709/RepGreen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 

Repository files navigation

gambar



A GitHub Contribution Graph Manager — fill, automate, and manage your GitHub graph with ease.


GitHub last commit


What is RepGreen?

RepGreen is a Python-based CLI tool that lets you take full control of your GitHub contribution graph. Whether you want to fill it up, clear it out, or automate daily updates — RepGreen has you covered.


Features

Feature Description
Custom Contribution Pattern Complete flexibility to commit to any specific year, month, or weekday pattern.
Automated History Reset Efficiently wipe all history via automated repository deletion and recreation.
Serverless Automation Integrated GitHub Actions to automatically add daily squares without requiring an external server.
170+ Timezone Support Precision scheduling that aligns perfectly with your local time across 170+ global timezones.
Adjustable Commit Density Full control over contribution intensity with options for Light, Medium, Heavy, or Custom density.
Token-Based Security Enhanced security protocols where tokens are entered manually and never stored within the source code.

Security Notice: Always use a Personal Access Token (PAT) and ensure that sensitive credentials are never exposed in public repositories.


Getting Started

1. Install

git clone https://github.com/N1709/RepGreen.git
cd RepGreen
python3 repgreen.py

2. Generate Token

Go to github.com/settings/tokens/new and enable:

repo          (full control)
delete_repo   (for clear and reset)
workflow      (for GitHub Actions setup)

3. Run and Follow the Menu

MAIN MENU
  1 | Fill contribution graph     create commits to green up your profile
  2 | Clear contribution graph    wipe all commits from a repository
  3 | Auto Schedule               auto-update graph every day
  4 | Exit

Auto Schedule — GitHub Actions

RepGreen can push a workflow directly to your repo that runs every single day at your chosen local time — powered entirely by GitHub's own servers, completely free.

Setup:

  1. Select Menu 3 — Auto Schedule — Setup GitHub Actions
  2. Choose your repo, timezone, and time
  3. Add a GitHub Secret named REPGREEN_TOKEN with your token value
  4. Done — one green square every day, forever

Fill Modes

Mode Description
Full year It will not be full because it follows the hours and days listed.
Full year (force) Jan to Dec including future
Specific month One chosen month only
Specific weekday Every Monday, Friday, etc.
automatic Every day will be updated automatically.

Disclaimer

This is just for fun. And please stay an honest developer. Use responsibly




This was made purely out of boredom. I had nothing else to do.

About

A Python-based tool to automate and customize your GitHub Contribution Graph using GitHub Actions.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages