L'avancement de notre projet en vidéo

En découvrant le petit utilitaire gource, nous avons décidé de partager avec vous le gource de notre projet (à partir de son dépôt Git principal).

C’est une vidéo qui représente visuellement l’avancement d’un projet Git dans le temps en construisant en temps réel un arbre représentant l’arborescence des fichiers du dépôt ainsi que les différents collaborateurs y apportant des modifications. Sur des projets Git de grande ampleur avec beaucoup de fichiers, le rendu est assez impressionant.

Voyez par vous-même avec cette vidéo représentant le gource de notre dépôt Git au 28 mars 2019 :

Gource ne permet pas nativement de faire des vidéos prêtes à être partagées sur Internet, pour cela il faut exporter chaque image de la vidéo (donc le nombre dépend de la fréquence : 25, 30 ou 60 fps) puis les retraiter à l’aide d’un autre utilitaire afin de former une vidéo au format MP4.

Par exemple, les deux commandes utilisées pour générer cette vidéo furent les suivantes :

gource -1280x720 -s 1 --filename-time 2.0 -r 25 -o gource.ppm

# le gource s'affiche et c'est lorsque que l'on ferme la fenêtre qu'il s'arrête
# d'enregistrer

ffmpeg -y -r 25 -f image2pipe -vcodec ppm -i gource.ppm -vcodec libx264 -preset medium -pix_fmt yuv420p -crf 1 -threads 0 -bf 0 gource.mp4

# ffmpeg s'occupe de transformer le fichier .ppm qui contient chaque image de la vidéo
# en une vidéo MP4

Les arguments utilisés pour gource permettent de définir, dans leur ordre d’apparition : la résolution, le nombre de secondes par jour, la durée d’affichage du nom d’un fichier, le nombre d’images par seconde et enfin le fichier de sortie.

Les arguments de ffmpeg reprennent basiquement le fichier d’entrée (-i) et le nombre d’images par seconde (-r).

CatFish Production.

Pour aller plus loin :