A tool to help you check if your email(s) have appeared in a data-breach!
WWWE.py is a standalone python script that checks an email or a list of emails using popular online services to see it the email(s) appear on any security-breach happened in the past. The online services used are:
$ python WWWE.py -h
usage: WWWE.py [-h] (-e | -f ) [--timeout]
WWWE.py: What's Wrong With my Email.
optional arguments:
-h, --help show this help message and exit
-e , --email Specify an email to check.
-f , --file Specify a file that contains a list of emails.
--timeout Specify HTTP connection timeout [default 10 sec]
Example
Requirements - Installation:
This project requires the following being installed on your system:
- python-requirements
- geckodriver
- PhantomJS
- Firefox
You can install the first three automatically using the setup.sh script (for the time only Linux/Mac OS are supported) or manually as follows:
To install the python-requirements :
pip install -r requirements.txt --upgrade --user
But you also need to install:
TODO
- Add the ability to save the results in csv format (work in progress).
- Provide results in a json format also, so the results be easily used and accessed by other tools.
Contributions & Feedback
Feedback and contributions are welcome. If you find any bug or have a feature request feel free to open an issue, and as soon as I review it I'll try to fix it!
Disclaimer
This tools is only for testing and academic purposes and can only be used where strict consent has been given. Do not use it for illegal purposes! It is the end user’s responsibility to obey all applicable local, state and federal laws. Developers assume no liability and are not responsible for any misuse or damage caused by this software.
Credits
- Logo designed with fontmeme.com!
License
This project is licensed under the GPLv3 License - see the LICENSE file for details