Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thoughtfuldev/eagleeye
Stalk your Friends. Find their Instagram, FB and Twitter Profiles using Image Recognition and Reverse Image Search.
https://github.com/thoughtfuldev/eagleeye
face-recognition machine-learning python3 social-media stalking
Last synced: 27 days ago
JSON representation
Stalk your Friends. Find their Instagram, FB and Twitter Profiles using Image Recognition and Reverse Image Search.
- Host: GitHub
- URL: https://github.com/thoughtfuldev/eagleeye
- Owner: ThoughtfulDev
- License: wtfpl
- Created: 2018-02-17T13:58:57.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-25T16:20:23.000Z (7 months ago)
- Last Synced: 2024-10-02T19:09:54.968Z (about 1 month ago)
- Topics: face-recognition, machine-learning, python3, social-media, stalking
- Language: Python
- Homepage:
- Size: 169 KB
- Stars: 4,211
- Watchers: 137
- Forks: 557
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
```
$$$$$$$$\ $$\ $$$$$$$$\
$$ _____| $$ | $$ _____|
$$ | $$$$$$\ $$$$$$\ $$ | $$$$$$\ $$ | $$\ $$\ $$$$$$\
$$$$$\ \____$$\ $$ __$$\ $$ |$$ __$$\ $$$$$\ $$ | $$ |$$ __$$\
$$ __| $$$$$$$ |$$ / $$ |$$ |$$$$$$$$ | $$ __| $$ | $$ |$$$$$$$$ |
$$ | $$ __$$ |$$ | $$ |$$ |$$ ____| $$ | $$ | $$ |$$ ____|
$$$$$$$$\\$$$$$$$ |\$$$$$$$ |$$ |\$$$$$$$\ $$$$$$$$\\$$$$$$$ |\$$$$$$$\
\________|\_______| \____$$ |\__| \_______| \________|\____$$ | \_______|
$$\ $$ | $$\ $$ |
\$$$$$$ | \$$$$$$ |
\______/ \______/
```
---
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](#getting_started)
- [Usage](#usage)
- [Built Using](#built_using)
- [TODO](#todo)
- [Authors](#authors)
- [Acknowledgments](#acknowledgement)
## 🏁 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**
1. Clone the Repository
``` $ git clone https://github.com/ThoughtfulDev/EagleEye ```
2. ```
$ cd EagleEye
$ sudo docker build -t eagle-eye .
```
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 \
eagle-eye
```
The result should now be in `/path/to/result`
---
#### Automated Prerequisites Installation (If Docker doesn't work)
```
wget https://raw.githubusercontent.com/ThoughtfulDev/EagleEye/master/install.sh && chmod +x install.sh && ./install.sh
```
---
#### Manual Prerequisites 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](https://github.com/mozilla/geckodriver/releases/latest) 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
```
### 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](https://www.python.org/) - Language
- [dlib](http://dlib.net/) - Face detection
- [face_recognition](https://github.com/ageitgey/face_recognition) - dlib python api
- [Selenium](https://www.seleniumhq.org/) - WebBrowser automation
## ✍️ Authors
- [@ThoughtfulDev](https://github.com/ThoughtfulDev) - Idea & Work