CatchME - WiFi Fun Box "Having Fun with ESP8266"
WiFi Fun Box
CatchME is developed by (Herwono W. Wijaya) @HerwonoWr, this project based upon the awesome work of (Stefan Kremser) @spacehuhn, (Sam Denty) @samdenty99, and other contributors. This project is a proof of concept for testing and educational purposes.
CatchME allows you to perform deauth attack, beacon, probe request flooding, and WiFi sniffing. CatchME (deauth attack) works by exploiting an old and known (deauth attack) vulnerability in the 802.11 WiFi protocol. CatchME also allows you to detect Deauth Attack.
CatchME has two operation mode, Attack Mode and Detector Mode, Detector Mode allows you to detect Deauth Attack.
WARNING
Use it only against your own networks and devices!. I don't take any responsibility for what you do with CatchME.
Please check the legal regulations in your country before using it. Do not redistribute, advertise or sell of this software as "jammer"!.
In order to install the firmware, you can use one of the following installation methods. Using NodeMCU Flasher or Arduino IDE, and for updating the firmware, you can use either NodeMCU Flasher, Arduino IDE, and CatchME UI. The NodeMCU Flasher method is easier overall but using Arduino IDE is better for debugging.
For the first time firmware installation, use NodeMCU Flasher or Arduino IDE. CatchME UI method is only can be use for updating the firmware.
YOU ONLY NEED TO DO ONE OF THE INSTALLATION METHODS!
ESP8266 board variants:
CP210x | CH34x |
---|---|
.bin
file using NodeMCU Flasher
Advanced
tab and select the correct values for your boardconfig
tab and click the gear icon for the first entry.bin
file you just downloaded and click openOperation
tab and click Flash(F)
Note: This guide is for Windows users
Download and install Arduino IDE
Download the current firmware release (source version)
MacOS Users
Arduino
> Preferences
http://arduino.esp8266.com/stable/package_esp8266com_index.json
to the Additional Boards Manager URLs
Windows Users
File
> Preferences
http://arduino.esp8266.com/stable/package_esp8266com_index.json
to the Additional Boards Manager URLs
Go to Tools
> Board
> Boards Manager
Type in esp8266
Select version 2.0.0
and click on Install
(must be version 2.0.0!)
Patching ESP8266 v2.0.0 Core
Go to Arduino
> Preferences
Find your packages path location under text More preferences can be edited directly in the file
Go to File
> Preferences
Find your packages path location under text More preferences can be edited directly in the file
Copy patch files in the esp8266-Patch folder to the following locations
Patch File | Path Location | Folder |
---|---|---|
user_interface.h | [packages-location]/packages/esp8266/hardware/esp8266/2.0.0/tools/sdk/include |
include |
ESP8266WiFi.cpp ESP8266WiFi.h |
[packages-location]/packages/esp8266/hardware/esp8266/2.0.0/libraries/ESP8266WiFi/src |
src |
ESP8266HTTPUpdateServer.cpp | [packages-location]/packages/esp8266/hardware/esp8266/2.0.0/libraries/ESP8266HTTPUpdateServer/src |
src |
Go to CatchME
folder, and open CatchME.ino
file in Arduino IDE
Select your ESP8266 board module (this guide using NodeMCU 1.0 (ESP12-E Module)) and the right port
Tools
> Board
, select the right board moduleTools
> Port
, select the right portDepending on your ESP8266 board, you may have to adjust the board configurations
Here is an example board configuration for NodeMCU 1.0 (ESP12-E Module)
Conf | Value |
---|---|
CPU Frequency | 80Mhz |
Flash Size | 4M (3M SPIFFS) |
Upload Speed | 115200 |
Click Upload
Note: This guide is for MacOS and Windows users
CatchME UI method only for updating the firmware, this method can't be use for first time installation.
SYSTEM INFO
menu, and click SELECT FIRMWARE FILE .BIN
.bin
file you just downloaded and click openIf you encounter an issue, you are welcome to submit it here.
Please provide as much context as possible:
Please check Contributing Guidelines to understand some basic conventions for contributing to this project.
Please make sure there are no existing pull requests to address the mentioned new features or issues. And, please check for issues related to the update, as someone else may be working on the issue.
Please check CODE OF CONDUCT to understand CatchME contributor covenant Code of Conduct.
CatchME is developed and maintained by (Herwono W. Wijaya) @HerwonoWr. This project is licensed under MIT License.
ESP8266 deauther and DeauthDetector written by (Stefan Kremser) is used in this project. It is distributed under MIT license.
Wi-PWN written by (Sam Denty) is used in this project. It is distributed under CC BY-NC 4.0.
Thanks for the awesome works: