# shpota/github-activity-generator

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/shpota-github-activity-generator).**

3,794 stars · 345 forks · Python · apache-2.0

## Links

- GitHub: https://github.com/Shpota/github-activity-generator
- awesome-repositories: https://awesome-repositories.com/repository/shpota-github-activity-generator.md

## Topics

`contribution-graph` `contributions` `generate` `generator` `git` `github` `github-app` `gitlab` `python` `python-script` `python2` `python3`

## Description

This project is a git commit simulator and activity graph generator designed to create dummy commits within a repository. It functions as a utility for customizing the visual appearance of a GitHub profile activity heatmap by simulating a history of contributions.

The tool allows for the customization of commit density and frequency across specified date ranges. It can target specific date windows and exclude weekends to control the distribution and volume of simulated activity.

The system manages the generation of these contributions by synthesizing commit timestamps and applying modifications to ephemeral files. It interacts with the local git environment to inject these changes in chronological order to populate the contribution graph.

## Tags

### Development Tools & Productivity

- [Contribution Graph Simulators](https://awesome-repositories.com/f/development-tools-productivity/contribution-graph-simulators.md) — Generates a series of simulated git commits to populate the GitHub activity graph heatmap. ([source](https://github.com/Shpota/github-activity-generator#readme))
- [Activity Graph Generators](https://awesome-repositories.com/f/development-tools-productivity/activity-graph-generators.md) — Creates simulated Git commits over a specified date range to populate the GitHub activity heatmap.
- [Commit Timestamp Generators](https://awesome-repositories.com/f/development-tools-productivity/commit-timestamp-generators.md) — Implements a system to generate precise git commit timestamps over specified date ranges.
- [Contribution Pattern Simulators](https://awesome-repositories.com/f/development-tools-productivity/contribution-pattern-simulators.md) — Provides deterministic logic to calculate and distribute commit density for realistic activity patterns.
- [Git Commit Simulators](https://awesome-repositories.com/f/development-tools-productivity/git-commit-simulators.md) — Provides a script that generates a series of dummy commits to mimic development activity.
- [Git History Injectors](https://awesome-repositories.com/f/development-tools-productivity/git-history-injectors.md) — Applies synthesized commits in chronological order to accurately populate the repository's contribution graph.
- [Git History Simulators](https://awesome-repositories.com/f/development-tools-productivity/git-history-simulators.md) — Creates artificial commit logs over specific date ranges to mimic a consistent development track record.
- [Activity Density Controllers](https://awesome-repositories.com/f/development-tools-productivity/activity-density-controllers.md) — Allows controlling commit frequency and volume, including the ability to exclude weekends. ([source](https://github.com/Shpota/github-activity-generator/tree/main/.github))
- [Profile Activity Managers](https://awesome-repositories.com/f/development-tools-productivity/profile-activity-managers.md) — Controls commit density and frequency to customize the visual representation of GitHub profile activity.
- [Profile Aesthetic Tools](https://awesome-repositories.com/f/development-tools-productivity/profile-aesthetic-tools.md) — Customizes the appearance of a GitHub profile by controlling simulated commit density and frequency.

### DevOps & Infrastructure

- [Git Command Execution](https://awesome-repositories.com/f/devops-infrastructure/git-command-execution.md) — Interacts with the local git binary to stage changes and execute commit commands.

### Part of an Awesome List

- [Visual Heatmap Customizers](https://awesome-repositories.com/f/awesome-lists/devtools/github-profile-integrations/visual-heatmap-customizers.md) — Simulates a history of contributions to fill the GitHub activity graph with custom patterns.

### Operating Systems & Systems Programming

- [Commit Payload Generators](https://awesome-repositories.com/f/operating-systems-systems-programming/temporary-file-generators/commit-payload-generators.md) — Creates and modifies ephemeral files to ensure every simulated commit contains a unique change.