Fork changes

• cfg SDA/SCL display alternate pins
• center faces on display instead of aligned left
• remove extraneous spaces in some text strings
• battery shield + battery for portability

Wemos Battery Shield + 250mAh LiPo battery

Make sure your i2c display has pins ordered VCC/GND/SCL/SDA. If it's GND/VCC/SCL/SDA my method will not work.

Line the pins up with Wemon D1 Mini and Battery Shield ensuring VBUS/GND/TX/RX/3.3V/A0/RST match (the pins labels vary between revisions of D1 and Battery Shield but those shouldn't change). Use the sockets with the longer pins from the top through the D1 Mini, then through the Battery Shield, and should have a small sliver extending past the Battery Shield for the i2c display. Trim all the pins down EXCEPT for VBUS/GND/0/2 (D1 mini v4 - D1 mini v3 / Battery Shield v1.2 would be VBUS/GND/D4/D3). Remove the pins from the i2c display (a solder pump/sucker helps enormously) and solder display in place. Flash the D1 Mini w/code in Arduino IDE, attach battery JST connector to Battery Shield, pwn on the go!

#########################################

minigotchi - ミニゴッチ

An even smaller Pwnagotchi.

Intro

This is a project meant to showcase the use of low-level Wi-Fi frame manipulation in a Pwnagotchi-like matter with an ESP8266/ESP32. This firmware is designed with simplicity just as much as similarity to the Pwnagotchi, promoting configuration reusability, low(er) memory usage, and a little bit of mischief.

The Minigotchi can detect Pwnagotchis, and send "advertisements" for another Pwnagotchi to detect, along with deauthenticating devices connected to an AP. Originally meant to just befriend a local Pwnagotchi, I plan to improve it and extend its purpose, merely with an ESP8266 with 4 MB of memory.

We just made a discord server! Feel free to join!

Install guide

See the install guide.

Languages

The code is written in these languages.

• C
• C++

Note that the C++ in Arduino is slightly modified from what I have heard. See this Reddit question for more about this. Arduino probably has tweaked it to be more beginner-friendly, although still being low-level. The Pwnagotchi is a complex machine written in Python and Go, so code from the Pwnagotchi Project is not compatible with mine.

Prerequisites

• Arduino IDE
• A good understanding of coding/programming
• D1 Mini ESP8266 V4(or any other supported hardware in the wiki)
• A reliable and appropriate power source and supply for the hardware
• Patience (a lot of it)
• The ability to read

How it operates/works

See the wiki.

Hardware

See the wiki.

To do

See this project.

Contributing

See the Contributing Guidelines here.

FAQ

See the wiki.

Communication

See the wiki.

Last but not least... Some thank you's

If you believe your project wasn't properly credited, please let me know ASAP! Here's how you can communicate with me.

Thanks to these projects for making this a little bit more possible for me, I have used libraries/code from these projects and implemented it here:

• Pwngrid, this is what the project is trying to replicate, specifically the Pwnagotchi's system of peer detection. If this didn't exist, this project probably wouldn't have either.

• Arduino, mostly just the repository containing libraries for the project so I can build this code. Many libraries were used in this core repository.

• 80211Raw allows raw arbitrary frames to be received and sent through an ESP8266 or ESP32 using C and C++ in an interesting and useful POC. This was used to send the Pwnagotchi-like frames. Most of the previous releases used this library, but now not anymore.

• ESP8266 Deauther, the POC that shows that an ESP8266 can deauth and attack local access points. Deauthing is based on this project and is done in a very similar fashion. Not only that, but it can also send probes and create fake APs.

• ESP32 Marauder, similar to the ESP8266 Deauther, although packed with more features and support for Flipper Zero's ESP32 WiFi Card Module. It has wardriving capabilities, BLE, Pwnagotchi Scanning, and Deauthing available. This is a very cool project, I highly recommend checking this out if you have an ESP32.

• ESPAsyncWebServer, the library that allows a Web UI on the ESP8266, along with an AP.

• Milkydeveloper, idk what he did but he wanted to be here ig so...(this is totally not an advertisement)

• This is a set of projects, one of which was an ESP32 sniffer.

• esp8266-sniffer, an ESP8266 sniffer dedicated to finding probes from smartphones.

Made with ❤️ by @dj1ch and the rest of the Pwnagotchi-Unofficial team!