Skip to content
This repository has been archived by the owner on Aug 23, 2024. It is now read-only.

dj1ch/minigotchi

⚠️ Project Archived

Warning

I will no longer continue development due to a lack of maintenance and time. Use at your own risk, any issue made will not be acknowledged. However, I may return to this project, although this is unlikely.

Old README.md

minigotchi - ミニゴッチ

GitHub code size in bytes GitHub license GitHub contributors GitHub commit activity GitHub Repo stars

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!