Git Commit Art is a Node.js script that allows you to create artistic patterns on the GitHub contribution graph by manipulating commit dates. This project is designed for educational purposes to explore Git's commit history mechanics and the behavior of the contribution graph.
Note: Misusing this tool to artificially inflate contribution statistics or mislead others violates GitHub's terms of service and may result in account suspension.
- Random Commits: Generate a specified number of commits on random dates within the past year.
- Custom Text Patterns: Create commits on specific dates to form text patterns (e.g., "HACK") on the contribution graph.
- The script uses predefined 7x5 grid patterns for letters A-Z.
- For custom text commits, it calculates the dates corresponding to the cells needed to form the text on the contribution graph, starting from a user-specified date.
- Install Node.js
- Initialize a Git repository and link it to GitHub.
Run the following command to install the required dependencies:
npm install jsonfile moment simple-git random readline
You can run the script using one of the following commands:
node git_commit_modifier.js
node git_commit_modifier.js --text "HACK" --start-date "2023-01-01"
npm run start
- This will prompt you to choose between random commits or custom text commits.
- For random commits, you will be asked to enter the number of commits and the start date.
- For custom text commits, you will input the desired text and start date.
- Use this tool responsibly and for educational purposes only.
- Avoid using it to misrepresent your contribution activity on GitHub.
Contributions are welcome! To contribute:
- Fork this repository.
- Create a new branch for your feature or bug fix.
- Submit a pull request with your changes.
This project is licensed under the MIT License.
For questions or feedback, feel free to open an issue or submit a pull request.