The Python gitinspectorgui
tool facilitates detailed quantitative analysis
of the contribution of each author to selected repositories.
Html and Excel backends provide detailed Git statistics:
Output also provides detailed blame information per file. Output lines are colored by author, allowing for easy visual inspection and tracking of author contributions.
The GUI and CLI interface have the same options and functionality.
Executable apps with GUI interface are available for macOS and Windows. In addition, a Python package can be installed from PyPI.
Stand-alone executables for Windows and macOS can be downloaded from the releases page.
Download the gitinspectorgui-setup.exe file, execute it, and follow the on-screen installation instructions. The GitinspectorGUI executable will be available under the program group GitinspectorGUI.
The GitinspectorGUI app is only about 18MB in size, but it requires Git for Windows to be installed on your computer. Git for Windows is around 375MB in size and can be downloaded from git-scm.com.
Git for Windows presents numerous questions during installation. For users unfamiliar with Git, these questions might seem overwhelming. However, leaving all options at their default settings will ensure proper functionality. A drawback of using the default settings is that it may add extra context menu items in File Explorer and create a Git desktop icon.
Download the appropriate dmg file for your hardware. There are two versions for macOS:
macOS Intel: This version is for the old Intel MacBooks.
macOS Apple-Silicon: This version is for the newer MacBooks with Apple silicon. Currently the M1, M2, M3 and M4 versions.
Open the downloaded file by double clicking. This opens a window with the GitinspectorGUI app. Drag the icon onto the Applications folder or to a temporary folder, from where it can be moved to the Applications folder. You can then open the GitinspectorGUI app from the Applications folder.
The first time you open the GitinspectorGUI app, you will get an error message
saying either "GitinspectorGUI" can't be opened because Apple cannot check it
for malicious software or "GitinspectorGUI" can't be opened because it was not
downloaded from the App store. Dismiss the popup by clicking OK
. Go to Apple menu > System Preferences
, click Security & Privacy
, then click tab
General
. Under Allow apps downloaded from: you should see in light grey two
tick boxes: one for App Store and one for App Store and identified
developers. Below that, you should see an additional line:
"GitinspectorGUI.app" was blocked from use because it is not from an
identified developer, and after that, a button Open Anyway
. Clicking that
button will allow the GitinspectorGUI app to be executed.
For CLI versions, you need to have a working Python installation, so that you
can install GitinspectorGUI from PyPI via pip install gitinspectorgui
. You can
then execute the program by running python -m gigui -h
to display the help
info in the CLI.
You also need to have a working Git program. For Windows, see the instructions under the GUI heading.
Note that the program name is gitinspectorgui in PyPI, but the
name of the actually installed Python package is the abbreviated form gigui
.
Extensive online documentation can be found at the GitinspectorGUI Read the Docs website.