Gource is a software version control visualization tool.

See more of Gource in action on the Videos page.

Introduction

Software projects are displayed by Gource as an animated tree with the root directory of the project at its centre. Directories appear as branches with files as leaves. Developers can be seen working on the tree at the times they contributed to the project.

Currently Gource includes built-in log generation support for Git, Mercurial and Bazaar and SVN (as of 0.29). Gource can also parse logs produced by several third party tools for CVS repositories.

Synopsis

view the log of the repository (Git, SVN, Mercurial and Bazaar) in the current path:

gource

Requirements

Gource's display is rendered using OpenGL and requires a 3D accelerated video card to run.

Related Software

If you like Gource you may also want to check out Logstalgia, a web server access log visualization tool.

News

19 September 2011

Gource 0.37 has been released, fixing a few bugs with timestamps and directory deletion.

Changes since 0.35:

• Fixed SVN log GMT timestamp conversion.
• Fixed issue with sub-dirs of deleted dir not being removed in some cases.

27 June 2011

Gource 0.35 is out. This release fixes a few bugs and handles truncation on the file extension key display (enabled with --key or pressing K).

Changes since 0.34:

• Added long file extension truncation handling to file key (--key).
• Treat changes in Mercurial log files with the same time/user as one commit.
• Fixed handling of spaces in directory names with Mercurial.
• Fixed --font-colour option.

14 May 2011

Gource 0.34 has been released.

Gource now features an OpenGL 2.0 rendering pipeline which dramatically improves performance on large repositories, while still maintaining legacy support for older graphics cards.

A significant visual improvement in this version is the elimination of 'banding' artifacts in bloom via use of shaders where OpenGL 2.0 support is available (you can toggle the older render with P-key to see the difference).

Packagers may want to note that this release no longer depends on FTGL and instead uses a custom font library that calls freetype2 directly.

Changes since 0.32:

• Now using VBOs and shaders for faster rendering when OpenGL 2.0 is available.
• Eliminated bloom colour banding artifacts (requires OpenGL 2.0).
• New font rendering library derived from FTGL (FTGL no longer required).
• Single pass font/shadow rendering (with lots of help from Chris Forbes).
• Added --no-vsync option.
• Fixed bug where tree is out of alignment with object positions in windowed mode due to using the wrong display dimensions internally.
• Removed default max-files limit.
• Added --hide root option to not draw branches from the root directory.
• Fixed log parsing of Bazaar merges and tagged commits.
• --output-custom-log now skips unparsed log entries instead of exiting.

2 March 2011

Gource 0.32 has been released to fix a bug in the camera tracking of users (camera gets progressively further away over time) introduced in 0.29.

17 February 2011

Gource 0.31 has been released as a minor update to allow building Gource with the system library of TinyXML (used by the SVN and cvs2cl parsers) instead of the bundled version.

14 February 2011

Gource 0.30 has been released.

This version fixes a couple bugs in the recently added SVN log support.

Changes since 0.29:

• Fixed crash when SVN log entry contains no 'paths' element.
• Handle directory deletion (happens in SVN logs).

13 January 2011

Gource 0.29 has been released.

Changes since 0.28:

• SVN built-in support.
• cvs2cl log support (cvs-exp support is now deprecated).
• Made camera behaviour when zooming and selecting objects more intuitive.
• Improved interactive performance.
• Added file extension key (--key or toggled with 'K').
• Added mouse-over tool tips.
• Added --highlight-colour option.
• Added --hash-seed option. The S key now randomizes colours.
• Added --output-custom-log option.
• Exposed --time-scale option (previously only available interactively).
• Removed arbitrary 1024 maximum length limit for log lines.
• Fixed two file colouring bugs (quoted files from git, period in file path).
• Fix handling of avatars for UTF-8 usernames on MACOSX (Christian Köstlin).
• Recover from video mode failing to set due to multi-sampling (Siddhesh Poyarekar).

27 August 2010

Gource 0.28 has been released.

Changes since 0.27:

• Bazaar support for merged commits (Nick Moffit).
• C++ efficiency improvements (Oliver Smith).
• Improved cvs-exp log compatibility.
• Re-show name of user when adding a new action if user is idle.
• Added --padding option to control camera view padding.
• More accurate camera tracking (tracks the bounding boxes of objects).
• Improved automatic rotation logic.

24 July 2010

Gource 0.27 has been released.

There are a lot of changes in this version. Some highlights:

• Config file support (ini style .conf files) has been added. You can convert a gource command line to a conf file with --save-config CONF_FILE.
• Automatic camera rotation has been added which makes better use of the screen space.
• Support for logos, titles and background images to brand your gource videos.
• Take tga screenshots with F12. Combined with the --transparent option you can can use this to make gource decals.

Changes since 0.26:

• Display time stops at the time of the last commit.
• Users fade out when end reached rather than ending abruptly.
• Position slider is now hidden by default if recording a video.
• Automatic camera rotation for better use of screen space.
• Support international keyboards (Peter Kjellerstedt).
• C++ efficiency improvements (Jacob Metcalfe).
• Fixed crash when reading from STDIN.
• Fixed intermittent crash closing Gource when using --output-ppm-stream.
• Added ini style config file support (see --load/save-config).
• Added screenshot button (F12). Screenshots respect the alpha channel.
• Added --transparent to make the background see-through (for screenshots).
• Added --logo and --background-image options.
• Added --dont-stop option for manual exiting when recording videos.
• Added --stop-at-time option to stop Gource after a number of seconds.
• Added --hide 'mouse' option.
• Added --highlight-dirs option.
• Added --file-extensions to show filename extensions only.
• Added --user-filter REGEX option.
• Allow --file-idle-time 0 (files will never expire).
• Allow --start-position 'random' to set a random start position.
• --log-command VCS replaces multiple --log-command-VCS options.
• Replaced --disable-progress and --disable-bloom with arguments to --hide.