Gource Org #

Create Gource animations for an entire organization's repositories!

Installation

Install Python 3.8 or later
Create a virtual environment
```
python -m venv .venv
```

Activate the virtual environment

# bash
source .venv/bin/activate
# Windows (Powershell)
.venv/Scripts/Activate.ps1
# Windows (cmd)
.venv/Scripts/activate.bat

Install dependencies
```
pip install -r requirements.txt
```

Install gource

# Ubuntu 20.04
sudo apt install gource

Install ffmpeg
```
# Ubuntu 20.04
sudo apt install ffmpeg
```
Create a GitHub Personal Access Token (classic) with the repo scope.

Usage #

Configuration #

Make a copy of the file config.json.dist with the name config.json.

Set the token to the token you created in the setup.
Set the organization to the GitHub username of the org whose repos you want to animate.

Authors #

After running the script once, you can run the following command to list all the authors found across all repositories.

cat gource.log | cut -d '|' -f 2 | sort | uniq

Place these names in the config to deduplicate/rename authors

Creating the Animation #

Run the script

python gource_org.py

License #

This project is licensed under the Mozilla Public License v2.0

Note, however, that it requires gource and ffmpeg to be installed on your system. Since gource is licensed under GPL-3.0, the combined work may need to be used under the terms of the GPL-3.0 (consult a lawyer for your specific case).

Clone this repository