Repository visualization with Gource

As some of you already know, for the past 10 years I've been researching how to analyse, visualise and design collaborative processes and organizations. I started this research at Politecnico di Milano (MSc), then continued independently (, and then started a doctorate at Aalto University (Doctor of Arts). The research is still going on, and the Fab Academy might be an interesting context for this as well.

When I attended the Fab Academy in 2012 (here the documentation, under Exercises > 20 BONUS), I created a video of its process with the Gource software:

Embedded Video

At the moment, there are very few softwares for visualizing the process in a Git/Hg repository, and I will probably work on new visualization softwares soon, but it will take some time. Meanwhile, I used again Gource for visualizing the process in the repositories I worked with during this Fab Academy: Europe, and the Opendot + WeMake Fab Labs in Milan where I am the instructor. These videos were generated quite quickly, so they are not very refined at the moment, but they can give you an idea of what happened:

EU Repo

Embedded Video

WeMake Repo

Embedded Video

Opendot Repo

Embedded Video


On Linux, you can download and compile Gource. On Mac, I installed Gource with:

brew install gource

...and Avconv, for rendering the video, with:

brew install libav

You can then export a log file from the repo, in order to use that for rendering the video:

gource --output-custom-log file.log

The basic usage of Gource is without avatars. There are few scripts around that download avatars from, I modified them in two scripts: one that get avatars also from GitHub, and another that get avatars from a Mercurial repo:

There are many many options for controlling Gource, here's my setup for creating the video and converting at the same time:

gource 1280x720 --user-image-dir ../FabAcademy2015-WeMake/.git/avatar/ gource --seconds-per-day 1 --stop-at-end --highlight-users --multi-sampling --output-ppm-stream --output-framerate 30 --title "Fab Academy 2015 - WeMake (Milan)" --hide mouse,filenames,progress wemake.log -o - | avconv -y -r 30 -f image2pipe -vcodec ppm -i - -b 65536K wemake.mp4

The EU repo is too big: too many files and users, so I changed a bit the settings:

gource 1280x720 --user-image-dir ../europe/.hg/avatar/ gource --seconds-per-day 1 --stop-at-end --highlight-users --multi-sampling --output-ppm-stream --output-framerate 30 --title "Fab Academy 2015 - Europe" --hide dirnames,bloom,mouse,filenames,progress eu.log -o - | avconv -y -r 30 -f image2pipe -vcodec ppm -i - -b 65536K europe.mp4</div>

Original tutorial by:

Massimo Menichinelli - info at - massimo.menichinelli at

This work is licensed under a Creative Commons Attribution 4.0 International License.