https://github.com/mikehorn-git/forengit

A simple Git Forensic tool
https://github.com/mikehorn-git/forengit

Last synced: about 11 hours ago
JSON representation

A simple Git Forensic tool

• Host: GitHub
• URL: https://github.com/mikehorn-git/forengit
• Owner: MikeHorn-git
• License: mit
• Created: 2024-01-28T22:35:24.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2024-02-29T23:55:33.000Z (9 months ago)
• Last Synced: 2024-03-01T23:37:14.308Z (9 months ago)
• Language: Python
• Size: 51.8 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Git Forensics Tool

![image](https://github.com/MikeHorn-git/ForenGit/assets/123373126/2b3befbb-f0f8-44db-b806-a610c72681b3)

# Features

* History

  * Blame

  * Branches

  * Commits

  * Deleted Objects

* Hunt

  * Author

  * Emails

  * Exif metadata

  * Geo data

  * Gpg keys

  * Network data

* Run

  * Git filesystem check

  * Git visualization tool

  * Trivy repository scanner

  * VirusTotal suspicious file scanner

# Install Optional Requirements

* [Exif](https://github.com/exiftool/exiftool)

* [Gource](https://github.com/acaudwell/Gource)

* [Trivy](https://github.com/aquasecurity/trivy)

* [VirusTotal](https://github.com/veetaw/vtcli) with API key

## Arch

```bash

yay -S perl-image-exiftool gource trivy vt-cli

```

## Kali / Parrot

```bash

sudo apt install exif gource trivy unzip wget

wget https://github.com/VirusTotal/vt-cli/releases/download/1.0.0/Linux64.zip

unzip Linux64.zip

```

# Usage

```bash

usage: ForenGit.py [-h] [-a] [-c] [-e] [-x] [-g] [-hbl] [-hbr] [-hc] [-hd] [-ht] [-k] [-n] [-s] [-t] [-vt] [-vi]

A simple Git Forensic tool

options:

  -h, --help            show this help message and exit

  -a, --author          Display author

  -c, --check           Run a filesystem check

  -e, --emails          Display emails

  -x, --exif            Display exif metadata

  -g, --geolocation     Display latitude and longitude data

  -hbl, --history-blame

                        Display Git history branches

  -hbr, --history-branches

                        Display Git history branches

  -hc, --history-commits

                        Display Git history commits

  -hd, --history-deleted

                        Display Git history deleted objects

  -ht, --history-tags   Display Git history tags

  -k, --keys            Display Gpg keys

  -n, --network         Display network informations

  -s, --statistic       Display commits numbers by author

  -t, --trivy           Run Trivy

  -vt, --virustotal     Run Virustotal

  -vi, --visualize      Run Gource

```