$$$$$$$$\ $$\ $$$$$$$$\
$$ _____, $$, $$ _____, $$, $$$$$$\ $$$$$$\ $$, $$$$$$\ $$, $$\ $$\ $$$$$$\
$$$$$\ \____$$\ $$ __$$\ $$, $$ __$$\ $$$$$\ $$, $$, $$ __$$\
$$ __, $$$$$$$, $$ / $$, $$, $$$$$$$$, $$ __, $$, $$, $$$$$$$$, $$, $$ __$$, $$, $$, $$, $$ ____, $$, $$, $$, $$ ____, $$$$$$$$\\$$$$$$$, \$$$$$$$, $$, \$$$$$$$\ $$$$$$$$\\$$$$$$$, \$$$$$$$\
\________, \_______, \____$$, \__, \_______, \________, \____$$, \_______, $$\ $$, $$\ $$, \$$$$$$, \$$$$$$, \______/ \______/
? 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
knownfolder and aresultfolder 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