/minigotchi-ESP32

minigotchi ported to the ESP32. maintained by @dj1ch

Primary LanguageC++GNU General Public License v3.0GPL-3.0

minigotchi-ESP32 - ミニゴッチ

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

The Minigotchi ported to the ESP32

Intro

Due to a surge in people asking for ESP32 support, I have created this fork. Fundamentally the ESP8266 and ESP32 can perform similar functions, although the ESP32 has more features, memory, computing power, etc. We have more and more ESP32s being supported, feel free to ask me about supporting a device.

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 if you plan on contributing
  • Any ESP32* based microcontroller
  • 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.

  • 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.

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

  • esp-idf, the Espressif development framework for IOT devices like the ESP32

  • arduino-ESP32, the core Arduino libraries for the.

  • I'd also like to thank PiSugar for the partnership with Pwnagotchi-Unofficial! Your batteries are amazing and have contributed heavily in the creation of this project.

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