[[PageOutline(2-3, Contents)]]

= gitg =

== Introduction ==
gitg is a git repository viewer targeting gtk+/GNOME. One of its main objectives is to provide a more unified user experience for git frontends across multiple desktops. It does this not be writing a cross-platform application, but by close collaboration with similar clients for other operating systems (like GitX for OS X). 

gitg targets cases where it is useful to provide a graphical representation of git data or actions. The history view is a good example where graphical representation helps to get an overview of the repository. gitg does not aim to be an advanced tool which allows access to every feature of git through a graphical interface, it will however try to incorporate common actions which might require multiple actions on the command line (like staging, unstaging, reverting and committing).

=== Features ===
 * Browse revision history
 * Handle large repositories (loads linux repository, 17000+ revisions, under 1 second)
 * Commit changes
   * Stage/unstage individual hunks
   * Revert changes
 * Show colorized diff of changes in revisions
 * Browse tree for a given revision
   * Export parts of the tree of a given revision
 * Supply any refspec which a command such as 'git log' can understand to built the history
 * Show and switch between branches in the history view

You can find a roadmap of the upcoming release at: [milestone:0.1 Roadmap for 0.1]

== Screenshots ==
Please visit the [wiki:Screenshots] page to get a preview of what gitg looks like.

== Download ==
You can find all gitg releases at [wiki:Releases]. To try out the latest development version you can get the [#Source Source].

== Source ==
The gitg source is currently hosted on the git gnome repositories. You can clone the gitg repository using:

{{{git clone git://git.gnome.org/gitg}}}

or browse the source at http://git.gnome.org/cgit/gitg/

There is also a gitg repository on github which will be kept in sync for the moment, but eventually this will stop.