Reading the repo
Opening the box…
How to install on macOS
risinek/
Exploring possibilities of ESP32 platform to attack on nearby Wi-Fi networks.
C/C++ (CMake)#802-11#esp32#pmkid#wifi-security
Before you start
- Is it free?
- YesOpen source (MIT).
- Still maintained?
- Looks inactiveLast change 2.7 years ago. Fixes may not come. Latest release v1.0, 5.5 years ago.
- Can I trust it?
- Widely used3.2k stars, 5 years old. As with any download, get it from the official repo.
- Difficulty
- Moderate
- Time
- about 15 min
- Stars
- ★ 3,155
- Activity
- Quiet for 2.7 years
Saved setup from 3 h ago
Will it work on macOS?
Yes, it runs on macOS
- You'll build it yourself with C/C++ compiler, CMake.
Supported devices from the README: Hardware
This project was mostly build and tested on ESP32-DEVKITC-32E but there should not be any differences for any ESP32-WROOM-32 modules.
<p align="center"> <img src="doc/images/soucastky_8b.png" alt="Hw components" width="400"> </p>On the following pictures you can see a battery (Li-Pol accumulator) powered ESP32 DevKitC using following hardware:
- ESP32-DEVKITC-32E (cost 213 CZK/8.2 EUR/9.6 USD)
- 220mAh Li-Pol 3.7V accumulator (weights ±5g, cost 77 CZK/3 EUR/3.5 USD)
- MCP1702-3302ET step-down 3.3V voltage regulator (cost 11 CZK/0.42 EUR/0.50 USD)
- Czech 5-koruna coin for scale (weights 4.8g, diameter 23 mm, cost 0.19 EUR/0.23 USD)
Altogether (without coin) this setup weights around 17g. This can be further downsized by using smaller Li-Pol accumulator and using ESP32-WROOM-32 modul directly instead of whole dev board.
This setup cost me around 300 CZK (± 11.50 EUR/13.50 USD). Using the modul directly that costs around 80 CZK (± 3 EUR/3.5 USD) we can get to price of 160 CZK (± 6.5 EUR/7.5 USD) which makes this tool really cheap and available to almost everybody.
Power consumption
Based on experimental measurements, ESP32 consumes around 100mA during attack executions.
Start here
4 steps on macOS
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Check it supports your device / system
Compare yours with the README's “Hardware” list above before installing anything.
Clone the repository
Needs Git: xcode-select --install
git clone https://github.com/risinek/esp32-wifi-penetration-tool.git cd esp32-wifi-penetration-tool
Install the required runtimes
C/C++ compiler, CMake 3.5
xcode-select --install brew install cmake
Install dependencies
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release cmake --build build
From the README: Usage
Did you get it running?
No reports for macOS yet.
Still stuck? Get a written guide
GitManual AI Agent reads the 2 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.