Git Punchcard Plot

a tool to visualize the time distribution of commits
Alternatives To Git Punchcard Plot
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
4 years ago25August 02, 201942mitGo
Simple, seamless, lightweight time tracking for Git
3 years ago8July 14, 201532mpl-2.0Go
Automated time tracking for Git repositories. [DEPRECATED]
5 months ago10apache-2.0JavaScript
A versioning data store for time-variant graph data.
Git Punchcard Plot156
3 years ago5Python
a tool to visualize the time distribution of commits
68 years ago6May 21, 20157Ruby
Analyzes Git repository commit logs to compute developer working hours, weekly activity, and to detect death marches in software development.
8 years ago3mitRuby
Log your hours worked using Git
12 years agoShell
The programmer's time tracker
18 days ago15unlicenseJava
Lightweight time tracker for IntelliJ platform IDEs
Git Time Lapse26
9 months agoVim Script
Fork of git-time-lapse: Perforce-style for vim/neovim
Git Basecamp23
13 years agoRuby
Git post-commit hook to transparently log dev time to Basecamp
Alternatives To Git Punchcard Plot
Select To Compare

Alternative Project Comparisons


This is a small script to visualize the time when commits are committed in a git repository. The idea is stolen from Github's punchcard picture(Kudos to Github)!


Here's the generated picture from MongoDB project:

MongoDB Punchcard


Basic Usage

$ ./git-punchcard


Provides the punchcard of the git repository at .

Supply a path to the git repository

$ ./git-punchcard path=/media/username/code/project

Supply an output file name

$ ./git-punchcard file=output-1.png

Supply a width of the output file

$ ./git-punchcard width=2000


Opacity of the punch marks

$ ./git-punchcard opaque=0

In the normal mode, the opacity of the punch marks is dependent on the size of the punch mark. If you set opaque=0, then all the punches will be the same color. The size will be the only indication of the number of commits in that particular range.


Supply output timezone

$ ./git-punchcard timezone=+8.5

Convert all the commit times to UTC+8.5. This is useful if the project has contributors across the world and you want to find a common window of time when all contributors are working.


Git Options

You can pipe git options to the script using the flag gitopts

Following are only examples, any valid options that can be given to log can be piped to git-punchcard

# Show a punchcard of commits from 1st January
$ ./git-punchcard gitopts="--since='1st January 2017'"

# Show a punchcard of commits from the last month
$ ./git-punchcard gitopts="--since='1 month ago'"

# Show a punchcard of commits before a particular date
$ ./git-punchcard gitopts="--before='2nd January 2016'"

# Show a punch of commits before some period
$ ./git-punchcard gitopts="--before='1 month ago'"


It shows how this repository is developed in developer's time. As I see it, I can get a simple clue whether a project is a spare time project or this project is totally under a company's control, thus resulting in commits from 8AM to 6PM, Monday to Friday.


  • python (of course!)
  • pycairo module
  • git

Then you're free to go!


  • cp git-punchcard /usr/local/bin
  • make sure that /usr/local/bin is in your $PATH environment variable.
  • invoke git punchcard
  • in the same folder, you should see a file named output.png, that's the generated image.

If you want a different name, then simply invoke git punchcard file=<another-name.png>. The default width of a picture is 1100px. If you'd like to have a higher resolution, you can run git punchcard file=<another-name.png> width=<new-width>.

If you would like to filter by a particular author then do so as follows. (all parameters are available) git punchcard author=<authorname>

The image gets scaled automatically.


This project is under public domain, you can do whatever you want ;) However, if you're improving this tool a bit, you can freely fork it and then send me back a pull request. I would be very glad to integrate it.

Popular Commit Projects
Popular Time Projects
Popular Version Control Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.