Skip to content

Animated history for a git repo

This tutorial will walk you through how to install and use Gource, a tool that Shows an Animated Git repo Evolution with some Aesthetic Visuals

i will be showing you how to manually compile and install Gource on Antix Linux

Setup Gource

  1. Prepare

    Install Build Dependencies

    Terminal window
    sudo apt install libsdl2-dev libsdl2-image-dev libpcre2-dev libfreetype6-dev libglew-dev libglm-dev libboost-filesystem-dev libpng-dev libtinyxml-dev

    Download Source Codebase from Gource github

    Terminal window
    curl -L -o ~/Downloads/gource.tar.gz https://github.com/acaudwell/Gource/releases/download/gource-0.55/gource-0.55.tar.gz &&
    tar -xvf ~/Downloads/gource.tar.gz
  2. Compile & Install

    Terminal window
    cd ~/Downloads/gource-0.55/ &&
    ./configure &&
    make &&
    sudo make install

Usage

just cd into a git repo and run the gource command

Terminal window
$: cd git-project
$: gource

Common Error

if error occurs failed to load resource '.../data/file.png' while running the gource command, then you need to manually compile and install SDL2 as Suggested by this issue failed to load resource ‘/usr/local/share/gource/file.png’

Just run this command

Terminal window
sudo apt install build-essential git cmake libsdl2-dev &&
git clone https://github.com/libsdl-org/SDL_image.git &&
cd SDL_image &&
git checkout SDL2 &&
mkdir build &&
cd build &&
cmake .. &&
make &&
sudo make install