Skip to content

Instantly share code, notes, and snippets.

Forked from cgoldberg/
Last active November 10, 2019 15:56
Show Gist options
  • Save XueshiQiao/5910150 to your computer and use it in GitHub Desktop.
Save XueshiQiao/5910150 to your computer and use it in GitHub Desktop.
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

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

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