{"id":13537340,"url":"https://github.com/thoughtfuldev/eagleeye","last_synced_at":"2025-05-14T14:08:33.464Z","repository":{"id":37335750,"uuid":"121859737","full_name":"ThoughtfulDev/EagleEye","owner":"ThoughtfulDev","description":"Stalk your Friends. Find their Instagram, FB and Twitter Profiles using Image Recognition and Reverse Image Search.","archived":false,"fork":false,"pushed_at":"2024-04-25T16:20:23.000Z","size":173,"stargazers_count":4768,"open_issues_count":38,"forks_count":641,"subscribers_count":138,"default_branch":"master","last_synced_at":"2025-04-11T18:22:39.756Z","etag":null,"topics":["face-recognition","machine-learning","python3","social-media","stalking"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"wtfpl","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ThoughtfulDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-17T13:58:57.000Z","updated_at":"2025-04-09T11:22:24.000Z","dependencies_parsed_at":"2024-10-15T02:41:37.529Z","dependency_job_id":"08f0a901-62f8-4a42-af63-60adef262099","html_url":"https://github.com/ThoughtfulDev/EagleEye","commit_stats":{"total_commits":71,"total_committers":9,"mean_commits":7.888888888888889,"dds":0.352112676056338,"last_synced_commit":"bcd580bd59cd92862a708b12d9d53f2fa5fb37e5"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThoughtfulDev%2FEagleEye","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThoughtfulDev%2FEagleEye/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThoughtfulDev%2FEagleEye/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ThoughtfulDev%2FEagleEye/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ThoughtfulDev","download_url":"https://codeload.github.com/ThoughtfulDev/EagleEye/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254160393,"owners_count":22024568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["face-recognition","machine-learning","python3","social-media","stalking"],"created_at":"2024-08-01T09:00:57.815Z","updated_at":"2025-05-14T14:08:33.444Z","avatar_url":"https://github.com/ThoughtfulDev.png","language":"Python","funding_links":[],"categories":["\u003ca id=\"9eee96404f868f372a6cbc6769ccb7f8\"\u003e\u003c/a\u003e新添加的","\u003ca id=\"170048b7d8668c50681c0ab1e92c679a\"\u003e\u003c/a\u003e工具"],"sub_categories":["\u003ca id=\"31185b925d5152c7469b963809ceb22d\"\u003e\u003c/a\u003e新添加的","\u003ca id=\"dc74ad2dd53aa8c8bf3a3097ad1f12b7\"\u003e\u003c/a\u003e社交网络"],"readme":"```\r\n$$$$$$$$\\                    $$\\                 $$$$$$$$\\                    \r\n$$  _____|                   $$ |                $$  _____|                   \r\n$$ |      $$$$$$\\   $$$$$$\\  $$ | $$$$$$\\        $$ |     $$\\   $$\\  $$$$$$\\  \r\n$$$$$\\    \\____$$\\ $$  __$$\\ $$ |$$  __$$\\       $$$$$\\   $$ |  $$ |$$  __$$\\ \r\n$$  __|   $$$$$$$ |$$ /  $$ |$$ |$$$$$$$$ |      $$  __|  $$ |  $$ |$$$$$$$$ |\r\n$$ |     $$  __$$ |$$ |  $$ |$$ |$$   ____|      $$ |     $$ |  $$ |$$   ____|\r\n$$$$$$$$\\\\$$$$$$$ |\\$$$$$$$ |$$ |\\$$$$$$$\\       $$$$$$$$\\\\$$$$$$$ |\\$$$$$$$\\ \r\n\\________|\\_______| \\____$$ |\\__| \\_______|      \\________|\\____$$ | \\_______|\r\n                   $$\\   $$ |                             $$\\   $$ |          \r\n                   \\$$$$$$  |                             \\$$$$$$  |          \r\n                    \\______/                               \\______/         \r\n                                                                      \r\n```\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n\r\n![Python 3.5](https://img.shields.io/badge/Python-3.6%2B-blue.svg)\r\n![OS Linux](https://img.shields.io/badge/Supported%20OS-Linux-yellow.svg)\r\n![Lets stalk](https://img.shields.io/badge/Stalkermode-Activated-red.svg)\r\n\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\n\u003cp align=\"center\"\u003e You have at least one image of the person you are looking for and a clue about their name. \r\n\u003cbr\u003e\r\nYou enter this data into EagleEye and it tries to find Instagram, Youtube, Facebook, and Twitter Profiles of this person.\r\n    \u003cbr\u003e \r\n\u003c/p\u003e\r\n\r\n## 📝 Table of Contents\r\n- [Getting Started](#getting_started)\r\n- [Usage](#usage)\r\n- [Built Using](#built_using)\r\n- [TODO](#todo)\r\n- [Authors](#authors)\r\n- [Acknowledgments](#acknowledgement)\r\n\r\n\r\n## 🏁 Getting Started \u003ca name = \"getting_started\"\u003e\u003c/a\u003e\r\nThese instructions will get you a copy of the project up and running on your local machine for development and testing purposes.\r\n\r\n### Prerequisites\r\n\r\n- A system with a x-server installed (Linux)\r\n- Firefox installed\r\n\r\n#### When using docker\r\n- Only docker is required\r\n\r\n#### When you dont use docker\r\n- Python 3.6 or higher\r\n- Pythons pip\r\n\r\n\r\n### Installing\r\n\r\n#### Docker (Preferred)\r\n**Make sure that you have docker installed**\r\n**Make sure that you use a LINUX distribution as the host**\r\n1. Clone the Repository\r\n\r\n   ``` $ git clone https://github.com/ThoughtfulDev/EagleEye ```\r\n2. ```\r\n   $ cd EagleEye\r\n   $ sudo docker build -t eagle-eye .\r\n   ```\r\n3. Now create a `known` folder and a `result` folder anywhere on your PC.\r\n4. Put the images of the known person in the known folder.\r\n5. Change the name of the person your are searching for in `entry.sh`\r\n6. Start the container. **Make sure to edit the paths**:\r\n```\r\nsudo docker run -t --net=host --env=\"DISPLAY\" \\\r\n                           --volume=\"$HOME/.Xauthority:/root/.Xauthority:rw\"  \\\r\n                           -v  /path/to/known:/EagleEye/known \\\r\n                           -v  /path/to/result:/result \\\r\n                           -v /path/to/EagleEye/Repository/entry.sh:/entry.sh \\\r\n                           eagle-eye\r\n\r\n```\r\n\r\nThe result should now be in `/path/to/result`\r\n\r\n---\r\n\r\n#### Automated Prerequisites Installation (If Docker doesn't work)\r\n```\r\nwget https://raw.githubusercontent.com/ThoughtfulDev/EagleEye/master/install.sh \u0026\u0026 chmod +x install.sh \u0026\u0026 ./install.sh\r\n```\r\n\r\n---\r\n\r\n#### Manual Prerequisites Installation (If you are hardcore)\r\n\r\nFor **Debian** based Distros\r\n```\r\n$ sudo apt update \u0026\u0026 sudo apt upgrade -y\r\n$ sudo apt install git python3 python3-pip python3-dev\r\n$ sudo apt install libgtk-3-dev libboost-all-dev build-essential cmake libffi-dev\r\n$ git clone https://github.com/ThoughtfulDev/EagleEye\r\n$ cd EagleEye \u0026\u0026 sudo pip3 install -r requirements.txt\r\n$ sudo pip3 install --upgrade beautifulsoup4 html5lib spry\r\n```\r\n\r\nFor **Arch**\r\n```\r\n$ sudo pacman -Syu\r\n$ sudo pacman -S git python python-pip gtk3 boost cmake libffi\r\n$ git clone https://github.com/ThoughtfulDev/EagleEye\r\n$ cd EagleEye \u0026\u0026 sudo pip3 install -r requirements.txt\r\n$ sudo pip3 install --upgrade beautifulsoup4 html5lib spry\r\n```\r\n\r\n\r\nIf Firefox is installed, download the [latest release](https://github.com/mozilla/geckodriver/releases/latest) of the Geckodriver for you Architecture.\r\n\r\n**If you get a `broken pipe` Error use Geckodriver Version 0.19.1.**\r\n\r\n**Note: If you are using Firefox ESR (like Kali does) please use the Geckodriver Version 0.17.**\r\n\r\nMake the Geckodriver executable:\r\n```\r\n$ chmod +x /path/to/geckodriver\r\n```\r\n\r\nNote: 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).\r\n\r\nExample:\r\n```\r\n$ sudo ln -s /path/to/geckodriver /usr/local/bin/geckodriver\r\n```\r\n\r\n\r\n## 🎈 Usage \u003ca name=\"usage\"\u003e\u003c/a\u003e\r\n\r\n### Configuration: General\r\n\r\nChange the value in `config.json` to the path of the `geckodriver` e.g\r\n```\r\n{\r\n    \"DEFAULTS\": {\r\n        ...\r\n    },\r\n    \"WEBDRIVER\": {\r\n        \"ENGINE\": \"firefox\",\r\n        \"PATH\": \"/usr/local/bin/geckodriver\"\r\n    },\r\n    \"FILTER\": [\r\n        ....\r\n    ],\r\n    ...\r\n}\r\n```\r\n\r\n### Configuration: Images\r\n\r\nPut at least one Image of the Person you want to find in the `known` folder.\r\n\r\nSupported Filetypes are: **jpg/JPG, jpeg/JPEG, png/PNG, and bmp/BMP.**\r\n\r\n### Run\r\n\r\nThen run the program ;)\r\n```\r\n$ python3 eagle-eye.py\r\n```\r\n\r\nTo see a list of all available Options just type\r\n```\r\n$ python3 eagle-eye.py -h\r\n```\r\n\r\n*The ImageRaider Reverse Image Search can take some minutes 1-15 Minutes depending on the count of Images*\r\n\r\n\r\n## TODO \u003ca name = \"todo\"\u003e\u003c/a\u003e\r\n* Implement the Chrome Webdriver\r\n\r\n## ⛏️ Built Using \u003ca name = \"built_using\"\u003e\u003c/a\u003e\r\n- [Python](https://www.python.org/) - Language\r\n- [dlib](http://dlib.net/) - Face detection\r\n- [face_recognition](https://github.com/ageitgey/face_recognition) - dlib python api\r\n- [Selenium](https://www.seleniumhq.org/) - WebBrowser automation\r\n\r\n## ✍️ Authors \u003ca name = \"authors\"\u003e\u003c/a\u003e\r\n- [@ThoughtfulDev](https://github.com/ThoughtfulDev) - Idea \u0026 Work\r\n\r\n## 🎉 Acknowledgements \u003ca name = \"acknowledgement\"\u003e\u003c/a\u003e\r\n- The movie Eagle Eye\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtfuldev%2Feagleeye","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthoughtfuldev%2Feagleeye","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtfuldev%2Feagleeye/lists"}