ESP32 S3 - Mini Mp3 Player Module

Hardware Preparation

Or you can buy the following kits:

Overview of the Mini Mp3 Player Module

The DIYables Mini Mp3 Player is a YX5200-24SS mp3 decoder module that plays audio files from a micro SD card through a built-in amplifier. It communicates over UART serial at 9600 baud and includes a 3W amplifier for direct speaker connection, making it a self-contained audio solution that requires no external decoder or amplifier IC.

Key Specifications

• Operates at 3.3V–5V (perfect for ESP32 S3's 3.3V logic)
• Controls via UART serial at 9600 baud
• Built-in 3W amplifier for direct speaker connection
• Supports up to 255 tracks and 99 folders
• 31 volume levels (0–30)
• 6 equalizer presets (Normal, Pop, Rock, Jazz, Classic, Bass)
• Multiple repeat and shuffle modes
• Status query capabilities for volume, track number, and playback state
• No external decoder or amplifier IC required
• Beginner-friendly with simple serial commands

Pinout

The Mini Mp3 Player module has 11 pins covering power, communication, audio output, and control functions.

1. VCC: Power supply (3.2V–5.0V)
2. GND: Ground connection
3. RX: UART receive (connect to ESP32 S3 TX pin)
4. TX: UART transmit (connect to ESP32 S3 RX pin)
5. SPK_1: Speaker positive terminal (built-in 3W amplifier)
6. SPK_2: Speaker negative terminal
7. DAC_R: Right channel line-level audio output
8. DAC_L: Left channel line-level audio output
9. BUSY: Status pin (LOW when playing, HIGH when idle)
10. IO_1: Button input (short press = previous, long press = volume down)
11. IO_2: Button input (short press = next, long press = volume up)

Wiring Diagram

Connect the Mini Mp3 Player to your ESP32 S3 using hardware Serial1, which provides reliable UART communication at the required baud rate. The ESP32 S3 operates at 3.3V logic, matching the module's signaling levels perfectly so no level-shifting resistors are needed on the TX/RX lines.

Safety Notes

Power the module from the 3.3V pin for low-volume applications, or from 5V (VBUS) if you need maximum speaker volume—the built-in amplifier performs better with higher supply voltage. Always connect GND before applying power, and ensure your speaker impedance matches the module's 3W amplifier rating to avoid damage.

This image is created using Fritzing. Click to enlarge image

SD Card Setup

The Mini Mp3 Player requires properly formatted and named files on your micro SD card.

Formatting requirements:

• File system: FAT16 or FAT32
• Card size: Up to 32GB recommended

Basic file naming (root directory):

Folder-based naming (organized playback):

Critical naming rules:

• Track numbering starts at 1 (not 0)
• Root files: 3-digit zero-padded names (001–255)
• Folder names: 2-digit zero-padded (01–99)
• Files in folders: 3-digit zero-padded (001–255)
• Copy order matters: The module determines playback order from the sequence files were copied, not alphabetical naming
• Best practice: Format card first, then copy files one by one in your desired playback order

Library Installation

The DIYables_MiniMp3 library simplifies control of the mp3 module for ESP32 S3 projects. Install it directly from the Arduino IDE Library Manager before uploading any of the example sketches.

• Connect your ESP32 S3 to your computer via USB-C cable
• Open the Arduino IDE
• Select ESP32 S3 as your board
• Choose the correct COM port
• Click the Libraries icon in the left sidebar
• Search for "DIYables_MiniMp3"
• Find the library by DIYables
• Click Install

• Search for DIYables_MiniMp3 created by DIYables and click the Install button.

Library benefits:

• Zero external dependencies
• Simple command functions for all playback features
• Works perfectly with ESP32 S3 hardware serial

ESP32 S3 Code — Basic Setup

The following code shows the basic template for controlling the Mini Mp3 Player with ESP32 S3 using hardware Serial1. It initializes the serial interface, waits for the module to boot, and sets an initial volume level so you can verify the connection is working before adding playback logic.

What this code does:

• Initializes Serial1 for mp3 module communication at 9600 baud
• Sets up the mp3 player object
• Waits for module boot-up
• Sets initial volume to level 25

Why hardware serial?

• ESP32 S3 has dedicated UART hardware
• More reliable than software serial
• No timing issues at 9600 baud
• Leaves USB serial free for debugging

ESP32 S3 Code — Play a Single Track

The following code demonstrates how to play a single track from your SD card using the ESP32 S3. It initializes the mp3 module and immediately begins playing track 001.mp3 so you can confirm the full hardware stack is working correctly.

Detailed Instructions

1. New to ESP32 S3? Complete our Getting Started with ESP32 S3 guide first.
2. Prepare SD card: Format as FAT32 and copy mp3 files with names 001.mp3, 002.mp3, etc.
3. Insert SD card: Place the micro SD card into the module's slot.
4. Connect wiring: Follow the wiring diagram above (VCC, GND, TX1, RX1, speaker).
5. Connect speaker: Attach your speaker to SPK_1 and SPK_2 terminals.
6. Open Arduino IDE: Launch the IDE on your computer.
7. Select board: Choose ESP32 S3 from the board menu.
8. Select port: Choose the correct COM port for your board.
9. Upload code: Copy the code above and upload to your ESP32 S3.
10. Listen: Track 001.mp3 should play through the speaker.
11. Pro Tip: If you hear no sound, check the SD card format and file naming—the module is very sensitive to naming conventions.

Playback Commands

ESP32 S3 Code — Play Multiple Tracks

The following code shows how to cycle through multiple tracks automatically, advancing to the next song every few seconds. This pattern is useful for background music systems or demo projects where you want continuous playback without user interaction.

Detailed Instructions

1. New to ESP32 S3? Complete our Getting Started with ESP32 S3 guide first.
2. Prepare SD card: Ensure you have at least 3 mp3 files named 001.mp3, 002.mp3, 003.mp3.
3. Wire module: Use the same wiring from the previous example.
4. Upload code: Copy and upload the sketch above.
5. Listen: Tracks will rotate every 5 seconds automatically.
6. Watch serial: Open Serial Monitor at 115200 baud to see track changes.
7. Pro Tip: Adjust the delay(5000) value to change how long each track plays before advancing.

Serial Monitor Output

ESP32 S3 Code — Volume Control

The following code adds two hardware buttons to your ESP32 S3 project so the user can raise or lower the mp3 player volume in real time. Each button press increments or decrements the volume by one step, and the current level is printed to the Serial Monitor for debugging.

Detailed Instructions

1. New to ESP32 S3? Complete our Getting Started with ESP32 S3 guide first.
2. Add buttons: Wire two buttons to GPIO4 and GPIO5 (plus GND).
3. Upload code: Copy the sketch above to Arduino IDE and upload.
4. Test buttons: Press the buttons while music plays to adjust volume.
5. Watch serial: Serial Monitor displays current volume level.
6. Pro Tip: Volume range is 0–30, with 15 being a good starting point for most speakers.

Volume Commands

Serial Monitor Output

ESP32 S3 Code — Next/Previous Buttons

The following code wires two buttons to your ESP32 S3 for manual track navigation, letting users skip forward or backward through the SD card playlist. The current track number is sent to the Serial Monitor each time a button is pressed.

Detailed Instructions

1. New to ESP32 S3? Complete our Getting Started with ESP32 S3 guide first.
2. Wire buttons: Connect NEXT button to GPIO4 and PREV button to GPIO5.
3. Connect ground: Wire the other button terminals to GND.
4. Upload sketch: Load the code above to your ESP32 S3.
5. Test navigation: Press buttons to skip forward or backward through tracks.
6. Monitor output: Serial Monitor shows current track number.
7. Pro Tip: Use pull-up resistors (10kΩ) for more reliable button operation in noisy environments.

Serial Monitor Output

ESP32 S3 Code — Pause/Resume Toggle

The following code uses a single button on your ESP32 S3 to toggle between paused and playing states, giving users a simple way to pause music without stopping the track entirely. The playback state is printed to the Serial Monitor so you can follow the logic during testing.

Detailed Instructions

1. New to ESP32 S3? Complete our Getting Started with ESP32 S3 guide first.
2. Wire button: Connect pause/resume button to GPIO4 and GND.
3. Upload code: Load the sketch to your board.
4. Start playback: Music begins automatically.
5. Toggle pause: Press button to pause, press again to resume.
6. Check status: Serial Monitor displays playback state.
7. Pro Tip: The BUSY pin on the module can also indicate play/pause state for visual feedback with an LED.

Serial Monitor Output

ESP32 S3 Code — Loop a Track

The following code programs the Mini Mp3 Player to repeat a single track continuously, which is ideal for background music or alert sounds that should never stop. Once uploaded to your ESP32 S3, no further interaction is needed—playback loops automatically.

Detailed Instructions

1. New to ESP32 S3? Complete our Getting Started with ESP32 S3 guide first.
2. Upload sketch: Load the code above.
3. Listen: Track 1 will repeat continuously.
4. Pro Tip: Use loopAll() for background music projects that need continuous playback across all tracks.

Repeat & Shuffle Commands

ESP32 S3 Code — Play from Folder

The following code demonstrates how to play a specific track from a numbered folder on your SD card, enabling organized playback for projects with multiple audio categories such as sound effects, music genres, or language packs.

Detailed Instructions

1. New to ESP32 S3? Complete our Getting Started with ESP32 S3 guide first.
2. Create folders: On your SD card, create folders named 01, 02, etc.
3. Add files: Place mp3 files in each folder (001.mp3, 002.mp3, etc.).
4. Upload code: Load the sketch to ESP32 S3.
5. Test playback: Code plays the first track from folder 01.
6. Pro Tip: Organize sound effects, music genres, or languages into separate folders for easy project organization.

Folder Methods

ESP32 S3 Code — Serial Monitor Control

The following code turns the Arduino IDE Serial Monitor into a full control panel for your Mini Mp3 Player, letting you test every playback feature by typing single-character commands. This is the recommended first sketch to run after wiring your ESP32 S3, since it lets you verify all functions before building a physical interface.

Detailed Instructions

1. New to ESP32 S3? Complete our Getting Started with ESP32 S3 guide first.
2. Upload code: Load the sketch to your ESP32 S3.
3. Open Serial Monitor: Set baud rate to 115200.
4. Send commands: Type commands from the table below.
5. Control playback: Use keyboard to test all mp3 player features.
6. Pro Tip: This is perfect for testing your mp3 module before building it into a larger project.

Serial Commands

Serial Monitor Output

Equalizer Presets

The Mini Mp3 Player offers six built-in equalizer modes to enhance audio quality for different music genres.

Available EQ presets:

Example usage:

Tips:

• EQ_NORMAL works well for voice recordings and podcasts
• EQ_BASS enhances small speakers with limited low-frequency response
• Try different presets to match your speaker characteristics

Status Query Functions

The library provides functions to read the current state of the Mini Mp3 Player module in real-time.

Important notes:

• Each query blocks execution for up to 100 milliseconds
• Functions return −1 on timeout or communication error
• Use these sparingly in time-critical applications

Available status functions:

Example code:

Application & Project Ideas

The ESP32 S3's dual-core processing and built-in WiFi make it especially well-suited for networked audio applications that go beyond simple local playback.

1. WiFi Audio Player: Build a WiFi-controlled home audio player with a web interface for remote track selection.
2. Talking Clock: Create a talking alarm clock with scheduled voice announcements for different times of day.
3. Museum Guide: Design an exhibit guide that plays audio descriptions automatically when visitors approach.
4. Interactive Toy: Make an interactive toy with sound effects triggered by motion or touch sensors.
5. Language Trainer: Build a language learning device with folder-organized lessons for vocabulary and pronunciation.
6. Smart Doorbell: Create a doorbell with customizable mp3 chimes selectable via a web interface.
7. Meditation Timer: Design a meditation timer with background music and voice prompts at timed intervals.
8. Retail Demo Unit: Build a product demo station with looping advertisement audio controlled remotely.

Video Tutorial

Watch the step-by-step video walkthrough for this ESP32 S3 project below.

Challenge Yourself

These projects build progressively on the skills you developed in this tutorial, taking your ESP32 S3 mp3 player from a simple demo to a polished, feature-rich device.

1. Beginner: Add an LED that lights up when music is playing using the BUSY pin.
2. Beginner: Create a 3-button jukebox that plays track 1, 2, or 3 on demand.
3. Intermediate: Build a web interface to control playback over the ESP32 S3's WiFi connection.
4. Intermediate: Add an LCD display showing the current track number and volume level.
5. Advanced: Create a voice-activated mp3 player using a microphone module and the ESP32 S3's ADC.
6. Advanced: Build a multi-room audio system with multiple ESP32 S3 boards synced over WiFi using UDP broadcasts.

Learn More

• ESP32 S3 - MP3 Player
• ESP32 S3 - Piezo Buzzer
• ESP32 S3 - Buzzer