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
reposcope.
Usage#
Configuration#
Make a copy of the file config.json.dist with the name config.json.
- Set the
tokento the token you created in the setup. - Set the
organizationto 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).