What is esp32_mp3_player?

ESP32 MP3 Player is a hobby electronics project that shares the code and wiring diagram for a small, homemade MP3 player built around the ESP32-C3 Super Mini microcontroller. It is a do it yourself hardware build rather than a piece of software you install on an existing device. The player reads MP3 files from an SD card up to 32 gigabytes in size, as long as the card is formatted as FAT32. It lists files and folders in alphabetical order and plays every track inside whichever folder you select. It shows artist and track name when that information is available, tracks how far into a song you are, and offers volume, play, pause, next, and back controls through physical buttons and a potentiometer. There are a few known limitations the author is upfront about. You cannot fast forward or rewind within a track, so songs always play from the beginning to the end. The file browsing menu is fairly demanding on the chip's resources, so audio playback pauses while you are navigating menus to keep things smooth. Only MP3 files should be placed on the SD card, since other file types can cause unexpected behavior. Building this player requires specific hardware: the ESP32-C3 Super Mini board itself, a PCM5102a digital to analog converter for audio output, a small monochrome OLED display, a standard SPI micro SD card reader, a TP4056 battery charging module, a rechargeable lithium polymer battery, several tactile buttons, a toggle switch, a potentiometer for volume, and a couple of capacitors. The README includes a full wiring schematic and a pin by pin list showing exactly which microcontroller pin connects to which component. On the software side, it relies on three existing libraries: ESP8266Audio for decoding MP3 data, GyverOLED for driving the display, and OneButton for handling button presses cleanly. This project suits electronics hobbyists and makers who enjoy soldering together their own gadgets and are comfortable following a wiring diagram and flashing microcontroller code.