How to visualize Git repositorys history - gerhardol/gitextensions GitHub Wiki

Requirements

choco upgrade gource -y
  • ffmpeg: Installed with chocolatey
choco upgrade ffmpeg -y

Steps

  1. Install needed requirements. If using GitExtensions plugins menu, no need to install gource, it will be downloaded for you if needed.

  2. Checkout whatever commit / branch you want to base the history off of or use --git-branch argument

  3. Run gource

    gource --dir-name-depth 1 -logo "Logo\git-extensions-logo-24px.png" -s .06 -1280x720 --auto-skip-seconds .1 --multi-sampling --stop-at-end --key --hide mouse,progress,filenames,dirnames --file-idle-time 0 --max-files 0  --background-colour 000000 --font-size 22 --title "Your Title Here" -o gource.ppm --highlight-colour 00FF00 --multi-sampling --high-dpi --frameless --highlight-users
    
    • If you want to a see a video of only your contributions then add --user-show-filter like --user-show-filter "Jay Asbury"
    • If you want to a see your contributions highlighted then add --highlight-user like --highlight-user "Jay Asbury" for example and remove --highlight-users
    • use --git-branch branch name here to use a specific branch

    Best way to do this is to use plugins menu. Command line arguments can be found at https://github.com/acaudwell/Gource

    gource plugin

  4. Run ffmpeg

    ffmpeg.exe -y -r 60 -f image2pipe -vcodec ppm -i gource.ppm -vcodec libx264 -preset slow -pix_fmt yuv420p -crf 1 -threads 0 -bf 0 gource.x264.mp4
    
    • Play with preset argument and other args to adjust as needed.
    • :warning: both gource and ffmpeg generate large files. Run on release 3.5 and 4.0 branches, files of these sizes were generated:
    gource3.5.x264.mp4     2,448,248,037 (2.5GB)
    gource4.0.x264.mp4     2,001,686,002 (2.0GB)
    gource3.5.ppm         49,830,278,768 ( 50GB)
    gource4.0.ppm         52,830,104,128 ( 53GB)
    
                   4 File(s) 107,110,316,935 bytes (107 GB)