Skip to the content
2 layers34 × 68 mmTamagotchi, the printed circuit board in 3D

Custom tamagotchi with a super small formfactor and can help you larp building hardware. Made using the good old ESP32 C3 Supermini, an 0.96 oled panel, three smol tactile switches, buzzer, and a battery ofc with a…

Size
34 × 68 mm
Copper layers
2
Thickness
1.6 mm
Parts
10
Nets
22
Pads
36
Tracks, vias
86, 0
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
20 Jun 2026
Updated
18 Aug 2026

Overview

Tamagotchi is an open-source printed circuit board by Ragh7av, from the Ragh7av/Tamagotchi repository on GitHub, published under the MIT licence. It is a 2-layer board of 34 × 68 mm with 10 parts on 22 nets, routed with 86 tracks and 0 vias.

Its parts include 3 switches and 2 ICs. It belongs with the ESP32 and RISC-V boards of this library.

README

README.md

Tamagotchi

Screenshot 2026-07-12 125353 IMG_20260819_025038 IMG_20260819_023629

Super smol tamagotchi pet for you!

Overview

Custom tamagotchi with a super small formfactor and can help you larp building hardware. Made using the good old ESP32 C3 Supermini, an 0.96 oled panel, three smol tactile switches, buzzer, and a battery ofc with a custom PCB and a 3D printed case!

Onshape 3D Model link

Schematic

Screenshot 2026-06-22 183809

Printed Circuit Board (PCB)

Screenshot 2026-06-25 202214 Screenshot 2026-06-25 175817 Screenshot 2026-06-23 164353

3D MODEL OF ASSEMBLY

Screenshot 2026-07-12 125339 Screenshot 2026-07-12 125330 Screenshot 2026-07-12 125319

ZINE

Zine-Tamagotchi

Why did I even build this?

to larp as a super smol cyberpet is cool asf.

The Features

Feeding: Fills the hunger meter (much like a crunchy kfc) with sound effects

Playing: Yooo... Pauses the normal world to launch the falling-item arcade game. Catching items makes the pet superrrr happy but sadlyy acts as a 20% battery tax on its energy.

Sleeping: Dims the screen into a snoozee/ sleeping mode, locking the controls until its energy battery safely recharges back to 100% and get's into full powerr.

IRL build photos

IMG_20260819_025038 IMG_20260819_023629 Screenshot 2026-08-19 022001 Screenshot 2026-08-19 021846 Screenshot 2026-08-19 021902 Using a Handmade case because of inaccessibility to a 3d printer or printing service in the region!

Youtube demo

Screenshot 2026-08-19 022827

Youtube video link

The Components Used

  1. ESP32 C3 supermini.
  2. 0.96-inch OLED Display (SSD1306)
  3. smol Buzzer.
  4. 6mm x 6mm x 8mm Tactile Switches (x3).
  5. Battery
  6. Custom designes PCB.
  7. Custom 3D Printed Case.

How to Build it?

1. Project Files and Parts

Download the necessary files from this repository:

  • Gerbers: For ordering the custom PCB.
  • 3D Prints: For printing the outer case.
  • Firmware: For the Arduino source code.

Now collect all the hardware components. You will need an ESP32-C3 Supermini, a 0.96-inch I2C OLED display, three 6mm tactile switches, a buzzer and a battery cell.

2. Hardware Assembly

To assemble the hardware follow these steps:

  1. Solder the ESP32-C3 Supermini onto the designated footprint on your PCB.
  2. Next solder the three switches into positions SW4, SW5 and SW6.
  3. Then solder the OLED display into the U2 slot.
  4. After that solder the buzzer to the BZ1 pads.
  5. Solder the battery wires to the BT1 power pads. It is very important to check the schematic to ensure the positive and negative match exactly to prevent shorting out the ESP32-C3 Supermini board.
  6. Finally, Place the PCB in the 3D printed bottom case and screw it to the case.

3. Software Environment Setup

To set up the software environment follow these steps:

  1. Install the Arduino IDE on your computer.
  2. Go to File then Preferences. Add the official ESP32 library URL to the Additional Boards Manager URLs box.
  3. Open Tools, Board then Boards Manager, search for ESP32 by Expressif and click install.
  4. Go back to Tools, Board, then ESP32 Arduino and select ESP32 C3 Dev Module.

4. Library Installation and Flashing

To install the library and flash the firmware follow these steps:

  1. Go to Sketch Include Library then Manage Libraries.
  2. Search for Adafruit SSD1306. Click install. Select "Install All" to include the required Adafruit GFX dependency.
  3. Open your project firmware file in the Arduino IDE.
  4. Connect the ESP32-C3 Supermini device to your computer using a data cable.
  5. Select the devices connection port, under Tools, Port.
  6. Click the Upload button. The OLED screen will boot up with the system text soon as the terminal finishes writing the code to the ESP32-C3 Supermini.

Inspirations & Credits

Huge thanks to the Fallout Hack Club Tamagotchi guide for the base inspiration and logic outline.

Parts

10
QtyValueFootprintReferences
3LOGOLOGOG***, G***, G***
3SW_Push_Dualfootprints:430182043816SW4, SW5, SW6
1Battery_Cellfootprints:TE_282837-2BT1
1Buzzerfootprints:BUZ-TH_BD9.6-P5.00-D0.6-FD_XHXDZ-TMB9650-5VBZ1
1DM-OLED096-636footprints:128x64OLED SSD1306U2
1ESP32-C3_SUPERMINI_THfootprints:MODULE_ESP32-C3_SUPERMINI_THU1

Similar boards

  • 2 layers57 × 55.2 mmLogicAnalyzer, the printed circuit board in 3D

    LogicAnalyzer

    gusmanb/logicanalyzer

    24 channel, 100Msps logic analyzer hardware and software

    10 parts5.1kGPL-3.0
  • 2 layers32.2 × 15.4 mmProtector, the printed circuit board in 3D

    Protector

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    10 parts4.3kMIT
  • 2 layers26 × 18 mmConn, the printed circuit board in 3D

    Conn

    yaqwsx/KiKit

    Automation tools for KiCAD

    10 parts2.1kMIT
  • 2 layers44.3 × 30.5 mmLime2-SATA RevA, the printed circuit board in 3D

    Lime2-SATA RevA

    OLIMEX/OLINUXINO

    OLINUXINO is Open Source / Open Hardware, low cost from EUR 24 Linux Industrial grade Single Board Computer capable to operate -25+85C

    10 parts1.5k
  • 2 layers17.8 × 43.2 mmNano Adapter, the printed circuit board in 3D

    Nano Adapter

    VoronDesign/Voron-Hardware

    Cool Hardware designed by the Voron Design group

    10 parts1.1kGPL-3.0
  • 2 layers53.9 × 23.2 mmBuffer, the printed circuit board in 3D

    Buffer

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    10 parts1kGPL-3.0

Questions

How big is the Tamagotchi PCB?

It measures 34 × 68 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Tamagotchi use?

10 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Tamagotchi KiCad files?

From the Ragh7av/Tamagotchi repository on GitHub, at the commit this page was made from: the board is PCB/Tamagotchi.kicad_pcb and its schematic PCB/Tamagotchi.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Tamagotchi design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).