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
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.

Alberto Fanjul's avatar
Alberto Fanjul committed
7
The latest version of gitg is 3.32.1.
Gaurav Agrawal's avatar
Gaurav Agrawal committed
8 9

- Website:      https://wiki.gnome.org/Apps/Gitg
Gaurav Agrawal's avatar
Gaurav Agrawal committed
10
- Issues:       https://gitlab.gnome.org/GNOME/gitg/issues
Gaurav Agrawal's avatar
Gaurav Agrawal committed
11 12 13 14 15
- Download:     http://download.gnome.org/sources/gitg/
- Mailing list: http://mail.gnome.org/mailman/listinfo/gitg-list

## Installing gitg

Alberto Fanjul's avatar
Alberto Fanjul committed
16
To install the latest version of gitg, make sure to download gitg-3.32.1.tar.xz from the download site. After downloading the following procedure installs gitg:
Gaurav Agrawal's avatar
Gaurav Agrawal committed
17 18

```
Alberto Fanjul's avatar
Alberto Fanjul committed
19 20
$ tar Jxf gitg-3.32.1.tar.xz
$ cd gitg-3.32.1
Gaurav Agrawal's avatar
Gaurav Agrawal committed
21 22
$ 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
```

## Building gitg from git

28
The gitg repository is hosted on gitlab.gnome.org. To build from git:
Gaurav Agrawal's avatar
Gaurav Agrawal committed
29 30

```
31
$ git clone https://gitlab.gnome.org/GNOME/gitg.git
Gaurav Agrawal's avatar
Gaurav Agrawal committed
32 33 34 35 36 37
$ cd gitg
$ meson --prefix=/usr build
$ ninja -C build
$ sudo ninja -C install
```

Alberto Fanjul's avatar
Alberto Fanjul committed
38
Alternatively you can build using Flatpak with the org.gnome.gitgDevel.json manifest.
Gaurav Agrawal's avatar
Gaurav Agrawal committed
39 40 41 42

## 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.