$$$$$$$$\ $$\ $$$$$$$$\
$$ _____| $$ | $$ _____|
$$ | $$$$$$\ $$$$$$\ $$ | $$$$$$\ $$ | $$\ $$\ $$$$$$\
$$$$$\ \____$$\ $$ __$$\ $$ |$$ __$$\ $$$$$\ $$ | $$ |$$ __$$\
$$ __| $$$$$$$ |$$ / $$ |$$ |$$$$$$$$ | $$ __| $$ | $$ |$$$$$$$$ |
$$ | $$ __$$ |$$ | $$ |$$ |$$ ____| $$ | $$ | $$ |$$ ____|
$$$$$$$$\\$$$$$$$ |\$$$$$$$ |$$ |\$$$$$$$\ $$$$$$$$\\$$$$$$$ |\$$$$$$$\
\________|\_______| \____$$ |\__| \_______| \________|\____$$ | \_______|
$$\ $$ | $$\ $$ |
\$$$$$$ | \$$$$$$ |
\______/ \______/
You have at least one image of the person you are looking for and a clue about their name.
You enter this data into EagleEye and it tries to find Instagram, Youtube, Facebook, and Twitter Profiles of this person.
๐ Table of Contents
๐ Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
Prerequisites
- A system with a x-server installed (Linux)
- Firefox installed
When using docker
- Only docker is required
When you dont use docker
- Python 3.6 or higher
- Pythons pip
Installing
Docker (Preferred)
Make sure that you have docker installed Make sure that you use a LINUX distribution as the host
-
Clone the Repository
$ git clone https://github.com/ThoughtfulDev/EagleEye
-
$ cd EagleEye $ sudo docker build -t eagle-eye - < dockerfile
-
Now create a
known
folder and aresult
folder anywhere on your PC. -
Put the images of the known person in the known folder.
-
Change the name of the person your are searching for in
entry.sh
-
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 \
eagle-eye
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
If 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).
Example:
$ sudo ln -s /path/to/geckodriver /usr/local/bin/geckodriver
๐ Usage
Configuration: General
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
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.
Run
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
TODO
- Implement the Chrome Webdriver
โ๏ธ Built Using
- Python - Language
- dlib - Face detection
- face_recognition - dlib python api
- Selenium - WebBrowser automation
โ๏ธ Authors
- @ThoughtfulDev - Idea & Work
๐ Acknowledgements
- The movie Eagle Eye