Gem Version Dependency Status Code Climate Coverage Status Build Status MIT Licensed

Generates an SVG of your Github contributions:

Example image

Other user example


Run githubchart path/to/svg to generate an SVG. To override the default username (pulled from your local shell or .gitconfig), use githubchart -u username path/to/svg

GithubChart also allows you to provide input from a file instead of pulling data from Github. You can pass JSON to GithubChart by using githubchart -i /path/to/file /path/to/svg, or use '-' to use STDIN. See spec/examples/input.json for example data.

If you don't provide a file path, the resulting SVG will be printed to stdout.

To modify the color scheme used, you can provide -c SCHEME. For example, githubchart -c halloween uses GitHub's halloween colors. Use -s to list the available schemes.


gem install githubchart


githubchart is released under the MIT License. See the bundled LICENSE file for details.