README.md 1.49 KB
Newer Older
Gaurav Agrawal's avatar
Gaurav Agrawal committed
1 2
# Gitg

Gaurav Agrawal's avatar
Gaurav Agrawal committed
3 4
<a href="https://flathub.org/apps/details/org.gnome.gitg"><img height="51" alt="Download on Flathub" src="https://flathub.org/assets/badges/flathub-badge-en.svg"/> </a>

Gaurav Agrawal's avatar
Gaurav Agrawal committed
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
gitg is a graphical user interface for git. It aims at being a small, fast and convenient tool to visualize the history of git repositories.  Besides visualization, gitg also provides several utilities to manage your repository and commit your work.

The latest version of gitg is 3.30.1.

- Website:      https://wiki.gnome.org/Apps/Gitg
- Bugs:         https://bugzilla.gnome.org/browse.cgi?product=gitg
- Download:     http://download.gnome.org/sources/gitg/
- Mailing list: http://mail.gnome.org/mailman/listinfo/gitg-list

## Installing gitg

To install the latest version of gitg, make sure to download gitg-3.30.1.tar.xz from the download site. After downloading the following procedure installs gitg:

```
$ tar Jxf gitg-3.30.1.tar.xz
$ cd gitg-3.30.1
$ meson --prefix=/usr build
$ ninja -C build
Alberto Fanjul's avatar
Alberto Fanjul committed
23
$ sudo ninja -C build install
Gaurav Agrawal's avatar
Gaurav Agrawal committed
24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
```

## Building gitg from git

The gitg repository is hosted on git.gnome.org. To build from git:

```
$ git clone http://gitlab.gnome.org/GNOME/gitg.git
$ cd gitg
$ meson --prefix=/usr build
$ ninja -C build
$ sudo ninja -C install
```

Alternatively you can build using Flatpak with the org.gnome.Gitg.json manifest.

## Using gitg

When gitg is installed, you can run gitg from the GNOME menu, or from a terminal by issueing: 'gitg'. Type 'gitg --help' to show the options you can specify on the command line.