gh-contributions-tetris-gif-maker

Generate a stunning animated Tetris-style GIF that beautifully visualizes a GitHub user's contributions for any specific year with the GitHub Contributions Tetris GIF Maker. This innovative script effortlessly transforms your coding activity into a unique animated visual representation, capturing your efforts in a fun and engaging way.

Key Features:

• Personalized GIF Creation: Input your GitHub username and the year of your choice, and instantly create a GIF showcasing your daily contributions using Tetris aesthetics.

• Easy to Use: Simply run the provided Python script, and you’ll have your Tetris GIF ready in no time. Here's how:

  python main.py -u <username> -y <year>
  

  For example:

  python main.py -u debba -y 2024
  

  The script generates github_tetris.gif, saved in the images folder, displaying the user debba's contributions in a vibrant Tetris layout.

• Docker Support: For users preferring containerization, easily build and run the Docker container while leveraging AWS for storage. Set up your crontab and Python upload scripts, and run your container securely with:

  docker run -d --name github-tetris-maker \
    -e AWS_ACCESS_KEY_ID=your_access_key_id \
    -e AWS_SECRET_ACCESS_KEY=your_secret_access_key \
    github-tetris-maker
  

• Prerequisites: Ensure you have the required Python packages installed, including Pillow, requests, and argparse, to get started quickly:

  pip install -r requirements.txt
  

Example Output

View a sample of the output GIF created for the user debba in 2023.

Creatively visualize your programming journey on GitHub and enjoy the playful side of coding contributions with this unique GIF generator!