LinuxCommandLibrary

gource

Animated version control history visualization

TLDR

Visualize current repo

$ gource
copy
Visualize specific repo
$ gource [/path/to/repo]
copy
Output video
$ gource -o - | ffmpeg -i - [output.mp4]
copy
Set time scale
$ gource --seconds-per-day [0.1]
copy
Hide filenames
$ gource --hide filenames
copy

SYNOPSIS

gource [options] [path]

DESCRIPTION

gource visualizes version control history as an animated tree. Developers appear as avatars making changes, with files and directories branching from the center in a real-time animation.
The tool supports Git, SVN, Mercurial, and Bazaar repositories. Output can be piped to video encoders like ffmpeg for creating shareable recordings of project history.

PARAMETERS

PATH

Repository path.
-o FILE
Output to file (- for pipe).
--seconds-per-day SEC
Speed of animation.
--hide ELEMENTS
Hide elements.
-s SEC, --start-date DATE
Start date.
-f, --fullscreen
Fullscreen mode.
--help
Display help information.

CAVEATS

OpenGL required. Large repos may be slow. Customize for best results.

HISTORY

gource was created by Andrew Caudwell to visualize software development history as engaging animations.

SEE ALSO

git-log(1), ffmpeg(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community