derdacavga/esp32-tamagotchi — explained in plain English
Analysis updated 2026-05-18
Build a physical virtual pet toy from scratch using cheap microcontroller hardware.
Learn embedded C++ and display programming through a small, self-contained project.
Swap in your own pixel art to create a custom-looking pet character.
| derdacavga/esp32-tamagotchi | bong-water-water-bong/npu-gpu-cpu | cloudcompare/normals_hough | |
|---|---|---|---|
| Stars | 3 | 3 | 3 |
| Language | C++ | C++ | C++ |
| Last pushed | — | — | 2018-02-23 |
| Maintenance | — | — | Dormant |
| Setup difficulty | hard | hard | moderate |
| Complexity | 4/5 | 5/5 | 3/5 |
| Audience | developer | researcher | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires soldering or assembling a custom ESP32-C3 board plus a separate display library from the same author.
This project shows you how to build your own physical Tamagotchi style pet using an ESP32-C3 microcontroller board, a small ST7789 screen, and the Arduino IDE. You feed it, play with it, clean it, and let it sleep, and if you neglect its stats too long the pet dies, though you can just restart and try again. The hardware is simple and hand buildable: a homemade ESP32-C3 board, a 1.69 inch display, three tactile buttons wired without needing extra resistors, and a small buzzer for sound. The author also mentions that swapping in a smaller ST7735 screen can free up memory if you want more animation frames. The code is organized into separate files for the character logic, button input, display drawing, hardware setup, and sprite images, so someone new to the project can find the piece they want to change without reading everything at once. You can adjust how fast the character moves, how animations tick, and how the mini games behave, all from within the code. To use your own pet artwork, you draw or generate 90x90 pixel images, convert them into a hex array using an online image to hex converter, and paste that array into the sprites file. To compile the project without errors, the author recommends specific versions of the Arduino IDE and the ESP32 boards manager, and building it also requires installing a companion display library the same author published separately for the ST7789 screen. The project is released under the GPL-3 license, so you are free to copy, modify, and share your own version of the device and its code. The README also links to a video tutorial that walks through the whole build step by step, along with a handful of separate mobile games by the same author that are not part of this repository.
A DIY open-source Tamagotchi clone you build with an ESP32-C3 microcontroller and a small screen, with fully editable pet logic, animations, and sprites.
Mainly C++. The stack also includes C++, Arduino IDE, ESP32-C3.
You can copy, modify, and share the code freely, but any redistributed versions must stay open source under the same GPL-3 license.
Setup difficulty is rated hard, with roughly 1day+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.