Igor Kromin |   Consultant. Coder. Blogger. Tinkerer. Gamer.

Gource is an awesome tool. It creates stunning, elastic visualisations of your RCS activity. I've written about it in the past when I first tried to use it on OSX with Subversion. Now that things have moved on and I am using Git I decided to give Gource another go.

What I wanted to do was build an animation of the Git commits we had for the last release of the project I'm working on. The Gource side is not too different after to how I described in my previous article, but the RCS (Git) log extraction does change. In the end I had this result (file names, users, anything identifying removed of course)...

So lets see how you get Gource going with Git...First extract the Git log between your two tags like so...
 Git Command:\
git log --pretty=format:user:%aN%n%at --reverse --raw --encoding=UTF-8 start_tag...end_tag > git.log

Replace start_tag and end_tag with your actual tag names. You can get a list of all tags by running 'git tag'.

Then to visualise the commits you can run Gource as follows:
 Gource Animation
gource --hide filenames,dirnames,usernames -c 4 -i 1200 --seconds-per-day 1 --camera-mode overview --bloom-multiplier 0.25 --bloom-intensity 0.25 -1280x720 --log-format git git.log

To create a video instead, you will need ffmpeg installed and the command now becomes this...
 Gource FFMPEG
gource --hide filenames,dirnames,usernames -c 4 -i 1200 --seconds-per-day 1 --camera-mode overview --bloom-multiplier 0.25 --bloom-intensity 0.25 -1280x720 --log-format git -o - git.log | ffmpeg -y -r 60 -f image2pipe -vcodec ppm -i - -vcodec libx264 -preset ultrafast -pix_fmt yuv420p -crf 1 -threads 0 -bf 0 gource.mp4

This is the video that I ended up with...


Hope you found this post useful...

...so please read on! I love writing articles that provide beneficial information, tips and examples to my readers. All information on my blog is provided free of charge and I encourage you to share it as you wish. There is a small favour I ask in return however - engage in comments below, provide feedback, and if you see mistakes let me know.

If you want to show additional support and help me pay for web hosting and domain name registration, donations, no matter how small, are always welcome!

Use of any information contained in this blog post/article is subject to this disclaimer.
comments powered by Disqus
Other posts you may like...