Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Generate a MP4 Video for your Git project commits using Gource!
# 1.install gource using HomeBrew
$ brew install gource
# 2.install avconv
git clone git://
cd libav
# it will take 3-5 minutes to complie, be patient.
./configure --disable-yasm
make && make install
# 3.generate a video for you repo.
$ cd your_repo_dir
$ gource \
-s .06 \
-1280x720 \
--auto-skip-seconds .1 \
--multi-sampling \
--stop-at-end \
--key \
--highlight-users \
--hide mouse,progress \
--file-idle-time 0 \
--max-files 0 \
--background-colour 000000 \
--font-size 22 \
--title "This is video Title @@@@@@@@@@@@@@@" \
--output-ppm-stream - \
--output-framerate 30 \
| avconv -y -r 30 -f image2pipe -vcodec ppm -i - -b 65536K movie.mp4
# It's Done! Just share the video with your teammates, Have fun!
Copy link

XueshiQiao commented Jul 2, 2013

The original gist is for Linux, My gist is for Mac, :)

I forked from cgoldberg/,it's Great! Thx @cgoldberg

Copy link

XueshiQiao commented Jul 2, 2013

If you just wanna watch the video, run these commands :

brew install gource
cd your_repo_dir

Copy link

cgoldberg commented Jul 2, 2013


Copy link

demonnico commented Jul 3, 2013


Copy link

ghost commented Jul 3, 2013


Copy link

gibffe commented Sep 15, 2015


Copy link

orrymr commented Apr 9, 2016


Copy link

wITTus commented Jul 27, 2016

The old avconv command may be substituted by ffmpeg, parameters are the same.

Copy link

gigabitwize commented Aug 4, 2016

How to use this? I get a lot of errors, with unknown commands etc..

Copy link

gbolcer commented May 14, 2018

Thanks, this is really useful. However, the generated video doesn't fit into the window. It only shows the upper left quadrant. The gource command renders the video correctly, but when I play the file back, it's like it didn't pay attention to the resolution settings. Any ideas?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment