Stalk Your Friends. Find Their Instagram, FB And Twitter Profiles Using Image Recognition And Reverse Image Search.This only works if their Facebook Profile is public

What does this do?

In simple words you have at least one Image of the Person you are looking for and a clue about its name. You feed this program with it and it tries to find Instagram, Youtube, Facebook, Twitter Profiles of this Person.

How does it work?

You give it a name and at least one photo. It then searches Facebook for this name and does Facial Recognition to determine the right Facebook Profile. After that it does a Google and ImageRaider Reverse Image Search to find other Social Media Profiles.If a Instagram Profile was found it will be verified by comparing your known photo of the Person to some of the Instagram Pictures.In the end you get a PDF Report 🙂

How to use it

Docker (Preferred)

Make sure that you have docker installed Make sure that you use a LINUX distribution as the host

  1. Clone the Repository$ git clone https://github.com/ThoughtfulDev/EagleEye
  2. $ cd EagleEye $ sudo docker build -t eagle-eye - < dockerfile
  3. Now create a known folder and a result folder anywhere on your PC.
  4. Put the images of the known person in the known folder.
  5. Change the name of the person your are searching for in entry.sh
  6. Start the container. Make sure to edit the paths:
sudo docker run -t --net=host --env="DISPLAY" \
                           --volume="$HOME/.Xauthority:/root/.Xauthority:rw"  \
                           -v  /path/to/known:/EagleEye/known \
                           -v  /path/to/result:/result \
                           -v /path/to/EagleEye/Repository/entry.sh:/entry.sh \

The result should now be in /path/to/result

Automated Prequisites Installation (If Docker doesn’t work)

wget https://raw.githubusercontent.com/ThoughtfulDev/EagleEye/master/install.sh && chmod +x install.sh && ./install.sh

Manual Prequisites Installation (If you are hardcore)

For Debian based Distros

$ sudo apt update && sudo apt upgrade -y
$ sudo apt install git python3 python3-pip python3-dev
$ sudo apt install libgtk-3-dev libboost-all-dev build-essential cmake libffi-dev
$ git clone https://github.com/ThoughtfulDev/EagleEye
$ cd EagleEye && sudo pip3 install -r requirements.txt
$ sudo pip3 install --upgrade beautifulsoup4 html5lib spry

For Arch

$ sudo pacman -Syu
$ sudo pacman -S git python python-pip gtk3 boost cmake libffi
$ git clone https://github.com/ThoughtfulDev/EagleEye
$ cd EagleEye && sudo pip3 install -r requirements.txt
$ sudo pip3 install --upgrade beautifulsoup4 html5lib spry

Firefox installation

Regardless of which option you choose make sure that you have Firefox installed.

If you are running a desktop version of Debian or Arch you likely have this installed already.

If you are not running a desktop version you may need to manually install.


Once Firefox is installed, download the latest release of the Geckodriver for you Architecture.

If you get a broken pipe Error use Geckodriver Version 0.19.1.

Note: If you are using Firefox ESR (like Kali does) please use the Geckodriver Version 0.17.

Make the Geckodriver executable:

$ chmod +x /path/to/geckodriver

Note: The geckodriver prefers to be in your path so wherever you do set it up you will likely need to setup a link to somewhere in your PATH (or add it to your PATH).


$ sudo ln -s /path/to/geckodriver /usr/local/bin/geckodriver

Configuration: General

Next change the value in config.json to the path of the geckodriver e.g

    "DEFAULTS": {
    "WEBDRIVER": {
        "ENGINE": "firefox",
        "PATH": "/usr/local/bin/geckodriver"
    "FILTER": [

Configuration: Images

Next put at least one Image of the Person you want to find in the known folder.

Supported Filetypes are: jpg/JPG, jpeg/JPEG, png/PNG, and bmp/BMP.


Then run the program 😉

$ python3 eagle-eye.py

To see a list of all available Options just type

$ python3 eagle-eye.py -h

The ImageRaider Reverse Image Search can take some minutes 1-15 Minutes depending on the count of Images

Leave a Reply

Leave a Reply