gource-organisation

Creating an organisation-wide gource animation

• Getting Gource
  • Installing Gource
    • On Linux
    • On macOS
    • On Windows
  • Using Docker
  • Install from source

Getting Gource

There are several ways to get Gource. Which one is best for you depends on your operating system and your preferences.

Installing Gource

Gource is available for Linux, Windows and Mac OS X.

On most distributions, Gource is available through the package manager.

On Linux

# Alpine
apk add gource 

# Arch Linux
pacman -S gource 

# Debian / Kali Linux / Ubuntu / Windows WSL2 / etc.
apt-get install gource 

# Fedora
dnf install gource 

^{source: https://command-not-found.com/gource}

On macOS

Gource can be installed on macOS using Homebrew or MacPorts.

# Homebrew
brew install gource 

# MacPorts
sudo port install gource 

^{source: https://github.com/acaudwell/Gource/wiki/Mac-Support}

On Windows

To use natively on Windows, Gource can be installed using Chocolatey.

choco install gource 

^{source https://community.chocolatey.org/packages/gource}

For those whom cannot (or do not want to) use Chocolatey, a Windows installer can be downloaded from the latest release page

At the time of this writing that is gource-0.53:

• https://github.com/acaudwell/Gource/releases/download/gource-0.53/gource-0.53.win64-setup.exe

It is also possible to install Gource on Windows using Windows Subsystem for Linux (WSL2).

sudo apt-get install gource

Using Docker

There are also several unofficial Docker images.

The most popular (and most up-to-date) are

• Envisaged - https://github.com/utensils/Envisaged
• Envisaged Redux - https://gitlab.com/Cartoonman/Envisaged-Redux/

After doing a docker pull, Gource can be run using docker run:

docker pull utensils/envisaged
docker run --rm -it \
    --name 'envisaged' \
    --port 8080:80 \
    --volume /path/to/your/repo:/visualization/git_repos:ro \
    utensils/envisaged

or

docker pull cartoonman/envisaged-redux
docker run --rm -it \
    --name 'envisaged-redux' \
    --port 8080:80 \
    --volume /path/to/your/repo:/visualization/resources/vcs_source:ro \
    cartoonman/envisaged-redux:latest

Both projects have more convenient ways to run Gource, for full details see their documentation.

Install from source

To get the latest version in development, Gource can also be build from source. It follows the standard autotools build process:

./autogen.sh
./configure
make
make install

Full details are beyond the scope of this article, but can be found the INSTALL file.