Need help with gitfiti?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

gelstudios
6.7K Stars 869 Forks MIT License 140 Commits 20 Opened issues

Description

abusing github commit history for the lulz

Services available

!
?

Need anything else?

Contributors list

Build Status

gitfiti noun : Carefully crafted graffiti in a github commit history calendar.

An example of gitfiti in the wild:
screenshot of gitfiti

gitfiti.py
is a tool to decorate your github account's commit history calendar by (blatantly) abusing git's ability to accept commits in the past.

How?

gitfiti.py
generates a script (powershell or bash) that makes commits with the GITAUTHORDATE and GITCOMMITTERDATE environment variables set for each targeted pixel.

Since this is likely to clobber repo's history, it is highly recommend that you create a new github repo when using gitfiti. Also, the generated script assumes you are using public-key authentication with git.

Pixel Art

pixel art examples
Included "art" from left to right: kitty, oneup, oneup2, hackerschool, octocat, octocat2

Usage

  1. Create a new github repo to store your handiwork.
  2. Run
    gitfiti.py
    and follow the prompts for username, art selection, offset, and repo name.
  3. Run the generated
    gitfiti.sh
    or
    gitfiti.ps1
    from your home directory (or any non-git tracked dir) and watch it go to work.
  4. Wait... Seriously, you'll probably need to wait a day or two for the gitfiti to show in your commit graph.

User Templates

The file format for personal templates is the following:

  1. Each template starts off with a ":" and then a name (eg. ":foo")
  2. Each line after that is part of a json-recognizable array.
  3. The array contain values 0-4, 0 being blank and 4 being dark green.
  4. To add multiple templates, just add another name tag as described in 1.

For example:

:center-blank
[[1,1,1,1,1,1,1],
[1,1,1,1,1,1,1],
[1,1,1,1,1,1,1],
[1,1,1,0,1,1,1],
[1,1,1,1,1,1,1],
[1,1,1,1,1,1,1],
[1,1,1,1,1,1,1]]

This would output a 7 x 7 light green square with a single blank center square.

Once you have a file with templates, enter its name when prompted and the templates will be added to the list of options.

Removal

Fortunately if you regret your gitfiti in the morning, removing it is fairly easy: delete the repo you created for your gitfiti (and wait).

License

gitfiti is released under The MIT license (MIT)


Todo

Notable derivatives or mentions

  • Vincent Van Git Vincent, which offers a very slick web ui to generate a gitfiti script
  • Pikesley's Pokrovsky, which offers Github History Vandalism as a Service!
  • PSVandalism Wrapper around Pokrovsky, which makes possible vandalising Github History from Powershell
  • github-board commits gitfiti from easy templates
  • ghdecoy fills the contribution graph with random data (sneaky!)
  • Gitfiti Painter visual drawing tool for artists to easily create templates
  • git-draw a Chrome extension which will allow you to freely draw on your commit map(!)
  • github-jack a pure bash version with space invaders and shining creepypasta
  • github-graffiti a GUI editor with a bash script to allow custom designs on your commit map
  • Paint GitHub is the most convenient way to paint your GitHub contribution graph!
  • Seen something else? Submit a pull request or open an issue!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.