PyGource

About

Render video of VCS repository commit history using Gource, with audio.

Setup

brew install ffmpeg gource mp3wrap youtube-dl

Usage

python pygource.py \
    --name "Project ACME" \
    --path /path/to/acme \
    --audio-source '/path/to/audio.mp3' \
    --audio-loops 10

Examples

Common

Get an audio file:

youtube-dl --extract-audio --format=m4a \
    --output="./var/Beastie boys - Suco De Tangerina.m4a" \
    https://www.youtube.com/watch?v=lpHWxf5xL0w

Convert it to MP3 format:

ffmpeg \
    -i "./var/Beastie boys - Suco De Tangerina.m4a" \
    -c:v copy -c:a libmp3lame -q:a 4 \
    "./var/Beastie boys - Suco De Tangerina.mp3"

Gource

Acquire sources:

git clone https://github.com/acaudwell/Gource ./var/Gource

Render and play video:

python pygource.py \
    --name "Gource" \
    --path "./var/Gource" \
    --audio-source "./var/Beastie boys - Suco De Tangerina.mp3" \
    --audio-loops 10

open -a vlc Gource.mp4

CrateDB

Acquire sources:

git clone https://github.com/crate/crate ./var/crate

Render and play video:

python pygource.py \
    --name "CrateDB 2022H2" \
    --path ./var/crate \
    --audio-source "./var/Beastie boys - Suco De Tangerina.mp3" \
    --audio-loops 10 \
    --outdir "./var" \
    --overwrite

open -a vlc "./var/CrateDB 2022H2.mp4"