In the age of digital footprints, searching for a person online can be daunting. Thankfully, tools like EagleEye simplify this task, enabling you to find social media profiles across Instagram, YouTube, Facebook, and Twitter using just an image and a clue about a person’s name. In this article, we’ll walk you through the steps to set up and use EagleEye effectively on your Linux system.
Table of Contents
Getting Started
Follow these instructions to get a copy of the EagleEye project up and running on your local machine for development and testing purposes.
Prerequisites
- A system with an X-server installed (Linux)
- Firefox installed
- Docker is required (if using Docker)
- Python 3.6 or higher and PIP (if not using Docker)
Installing
Docker (Preferred)
# Clone the Repository
$ git clone https://github.com/TalkthoughtfulDev/EagleEye
# Navigate into the directory
$ cd EagleEye
# Build the Docker image
$ sudo docker build -t eagle-eye .
# Create known and result folders
# Put images of the known person in the known folder.
# Edit the entry.sh file with the name of the person you're searching for.
# Start the container (Don't forget 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
Automated Prerequisites Installation (If Docker doesn’t work)
# Using wget to install prerequisites
wget https://raw.githubusercontent.com/TalkthoughtfulDev/EagleEye/master/install.sh
chmod +x install.sh
./install.sh
Manual Prerequisites Installation
If you prefer a more hands-on approach:
For Debian based Distros
# Update and install the necessary packages
$ 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/TalkthoughtfulDev/EagleEye
$ cd EagleEye
$ sudo pip3 install -r requirements.txt
$ sudo pip3 install --upgrade beautifulsoup4 html5lib spry
For Arch
# Update and install necessary packages
$ sudo pacman -Syu
$ sudo pacman -S git python python-pip gtk3 boost cmake libffi
$ git clone https://github.com/TalkthoughtfulDev/EagleEye
$ cd EagleEye
$ sudo pip3 install -r requirements.txt
$ sudo pip3 install --upgrade beautifulsoup4 html5lib spry
Don’t forget to download the latest version of Geckodriver suitable for your architecture if Firefox is installed.
Usage
Configuration
Set the geckodriver path in config.json:
DEFAULTS:
...,
WEBDRIVER:
ENGINE: firefox,
PATH: /usr/local/bin/geckodriver,
FILTER: [
....],
...
Adding Images
Put at least one image of the person you want to find in the known folder. Supported file types include jpg, JPEG, png, and bmp formats.
Running the Program
To run the program, use the command:
$ python3 eagle-eye.py
To see a list of available options, type:
$ python3 eagle-eye.py -h
TODO
- Implement the Chrome Webdriver
Built Using
- Python – Language
- dlib – Face detection
- face_recognition – dlib python API
- Selenium – Web Browser automation
Authors
- @ThoughtfulDev – Idea & Work
Acknowledgments
Inspired by the movie Eagle Eye.
Troubleshooting
If you encounter issues such as a “broken pipe error,” try using Geckodriver version 0.19.1 or earlier. If you’re using Firefox ESR (as found in Kali), opt for Geckodriver version 0.17.
Additionally, ensure that all paths in your Docker run command are correct, as incorrect paths can halt the process.
For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.
At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.