For those that love to use Git but don’t want to deal with the command line on Linux, there is Qgit Viewer – a Qt-based Git-viewing tool for Linux. With it, users can access Git repos to contribute code, patches and everything that the command line version of Git can do! Let’s discuss how to install it.

Preparing Qgit

Various Qt4 libraries and components are needed before the program builds. The program will not build correctly without these tools. The developer has failed to really list the exact components the user needs (in extreme detail). It is because of this that the best course of action is to use a wildcard in the terminal and use it to install everything Qt4 related. When the command completes, Qgit Viewer will be able to compile correctly. Get the source code for Qgit Viewer.

Extract the source code. Open a terminal and enter the source code directory.

Compiling Qgit Viewer

First, run the qmake command. This command will create the makefile. A makefile is key in the compiling process.

Qmake has created a Makefile. Run the make command to start the compilation of Qgit Viewer. Finally, to finish the compilation process, run the make command again but with the install command to finish the compiling process.

After the qmake, make and make install commands have run through, a new folder in the “qmake” directory will appear labeled “bin.” This folder contains the fully compiled Linux binary for use on Ubuntu.

Running Qgit viewer

To run Qgit Viewer, double-click on it (or right-click, then execute). The compiler should automatically set the correct permissions to allow the binary to run and execute as a program, so there’s no need to fiddle with it. Another way (and perhaps the best way) to run Qgit the first time is to run it from the terminal window itself. This is because the Linux terminal can output any errors directly, let the user know of missing dependencies, etc. To run Qgit from the terminal, enter the following:

Making a desktop icon

Creating a desktop icon for Qgit Viewer will help the program open more easily. To start, enter the Qgit bin directory with the terminal. Move the binary file to the /usr/bin/ directory.

The Qgit binary is in the right place. Now, let’s make the desktop icon. Open Gedit and paste the following into it. Save the file as “qgit-viewer.desktop.” Then, locate the saved desktop file. Right-click the file, select “Properties,” then the permissions tab. Check the box “allow executing file as a program,” and close the window. Place the desktop file in the application directory with:

Conclusion

With the Desktop icon made and everything taken care of, Qgit Viewer is installed on the Ubuntu desktop. From here, code patches, code contributions, and everything in-between can now be done with a nice GUI tool. So long as Git is configured on the system, everything should run smoothly!