GReverse

A reverse search tool for OSINT (Open Source Intelligence) gathering & facial recognition via Google Custom Search & Google Vision API's.

About

GReverse is a reverse search tool built for data researchers, penetration testers, security analysts, and more.

Why Use GReverse?

If all your given is an image, or name and you need more information, with GReverse you are able to perform accurate reverse image searches & data searches with a wide range of capabilties using OSINT (Open Source Intelligence).

Features

• Find full matching images, partial matching images, similar matching images, and more.
• Download results to a local directory of your own choice.
• See data in multiple formats: JSON, XML, RAW(dictionary), and Pretty(Readable Output).
• Utilize the builtin functionality of Python3's multiprocessing library to download images at blazing fast speeds.
• Choose the number of processes you think your system can handle for even faster multiprocessing functionality.
• Run builtin facial recognition against your results to see, if any, are the same person with the face_recognition library.
• Even restrict your own query searches to do normal Google searches when necessary, all under one hood.

Screenshots

This is the command line(CLI) interface.

Demonstration of GReverse with facial recognition enabled.

Installation Notice

GReverse uses Python3 natively, so you will need to have it installed before proceeding. Once you have done that follow the steps below.

Required Libraries Install Guide

To use GReverse, the following Python3 libraries will need to be installed. You can install them using the Python package manager pip. Below are the installation instructions for each library:

1. Google API Client Library (googleapiclient)

   You can install the Google API Client Library using pip:

   pip install google-api-python-client

2. Google Cloud Vision (google-cloud-vision)

   Install the Google Cloud Vision client library using pip:

   pip install google-cloud-vision

3. Protocol Buffers (google.protobuf)

   You can install the Protocol Buffers library using pip:

   pip install protobuf

4. Face Recognition (face_recognition)

   Install the Face Recognition library using pip:

   pip install face_recognition

5. TQDM (tqdm)

   You can install the TQDM library using pip:

   pip install tqdm

6. Dict2XML (dict2xml)

   Install the Dict2XML library using pip:

   pip install dict2xml

With these libraries installed, you can proceed to the next step which is configurations.

Configurations

To properly configure your Google Python3 installation, follow the guides below:

Python3_Google_Quickstart_Guide

Its recommended to have two programmable custom search engines. One configured for images only, and the other for links only. You will also need to add both search engine ID's to the creds.py file located in the api_creds folder.

Python3_Custom_Search_Guide

Contributors

I welcome you to contribute code to GReverse, and thank you for your contributions, feedback, and support.