WiFiHack is a straightforward brute-force tool designed to help users attempt to find WiFi passwords by leveraging the PyWiFi library in Python. Using a password list, WiFiHack tries each password systematically to connect to the specified WiFi network and gain access if the correct password is found.
Disclaimer: This tool is intended solely for educational purposes on personal WiFi networks. Do not use this tool on networks you do not have permission to access.
- WPA2PSK Authentication: Supports attempts to connect to networks secured with WPA2.
- Multithreaded Brute-Force: Utilizes
ThreadPoolExecutor
for efficient brute-force attempts. - Windows Compatibility: Designed to run on Windows PowerShell; it is not compatible with WSL.
- Interactive UI: Uses the
rich
library for a visually appealing, modern interface.
- Python >= 3.9
- Libraries:
pywifi
andrich
- Prepare Network Name and Password List Make sure you have the SSID of the target WiFi network and a text file containing a list of potential passwords.
- Run the Program
Open Windows PowerShell, navigate to the project folder, and run:
python Run.py
- Input Required Data When prompted, enter the WiFi network name (SSID) and the path to your password list file.
- Monitor the Process
The brute-force process will start, displaying each attempt. You can stop the process at any time by pressing
CTRL + Z
.
- Open the password file and verify it contains valid passwords, one per line. Remove any blank lines or entries that are too short (under five characters).
- A slow brute-force process may be due to a large password list or limited system resources. Try a smaller, optimized password list and ensure your system can handle multithreading.
- This usually means that the password list provided does not contain the correct password. Try using a more comprehensive or updated password list.
- Ensure that the password file is in the same folder as the program and that the file path is correct. Also, check that the file has read permissions.
- WiFiHack requires direct hardware access, which is limited in WSL. To resolve this, run the tool in Windows PowerShell or Command Prompt on Windows.
- If the program is interrupted mid-attempt, success and failure counts may be inaccurate. Restart the program and let it run uninterrupted for accurate results.
If you'd like to support the development of this project, consider donating:
Your support is greatly appreciated and helps keep this project alive and improving!
This tool cannot run in WSL (Windows Subsystem for Linux). If you attempt to run it in WSL, WiFiHack will display an error message and exit. To run WiFiHack, please use Windows PowerShell or Command Prompt on Windows.
WiFiHack is designed for testing on your own network. Misuse of this tool on unauthorized networks may be illegal. Please use this tool responsibly.
If you encounter any issues or want to contribute, feel free to open an issue or pull request in this repository.
© 2024 WiFiHack Project - For educational and research purposes only.