M5Mp3 Winamp Player for Cardputer-Adv (video)

M5Mp3 Winamp Player for Cardputer-Adv - Video Description

Projec Overview

This video demonstrates a fully functional Winamp-style MP3 player running on the **M5Stack Cardputer-Adv**. The project is an adaptation of the original M5Mp3 by VolosR, completely rewritten to work with the Cardputer-Adv's ES8311 audio codec and built-in display.

* GitHub Repository:* https://github.com/AndyAiCardputer/mp...

*Original Project:* [VolosR/M5Mp3](https://github.com/VolosR/M5Mp3)

What You'll See

*Classic Winamp Interface* - Authentic retro look with animated visualizer
*MP3 Playback* - Smooth audio playback from SD card
*Full Controls* - Play/pause, next/previous track, volume, brightness
*File Browser* - Scroll through your music collection
*Battery Indicator* - Real-time battery level display
*Visual Equalizer* - Animated bars that react to music

Technical Highlights

Audio System
*ES8311 Audio Codec* - Native support via M5Cardputer.Speaker API
*ESP8266Audio Library* - MP3 decoding with custom AudioOutput class
*Triple Buffering* - Smooth playback without glitches
*Stereo to Mono Conversion* - Optimized for Cardputer-Adv's mono output

Display & Interface
*240x135 Built-in Display* - Perfect for the Winamp interface
*FreeRTOS Multi-tasking* - Separate tasks for display and audio
*Smooth Animations* - 25 FPS display updates
*Scrolling Track Names* - Long filenames scroll automatically

Key Adaptations
Replaced ESP32-audioI2S with ESP8266Audio
Created custom AudioOutputM5CardputerSpeaker class
Removed I2S pin configuration (uses ES8311 API instead)
Replaced ESP32Time with simple millis() timer
Added MP3 file filtering

Hardware Requirements

M5Stack Cardputer-Adv
microSD card (FAT32 formatted)
MP3 files

Controls

*A* - Play/Pause
*N* - Next track
*P* - Previous track
*V* - Volume up (cycles: 5→10→15→20→5)
*L* - Brightness control
*B* - Random track
*ENTER* - Restart current track
*;* / *.* - Scroll through file list

Code Structure

The project uses FreeRTOS tasks running on different CPU cores:
*Task_TFT* (Core 0) - Handles display updates and keyboard input
*Task_Audio* (Core 1) - Manages MP3 decoding and playback

Audio pipeline: SD Card → AudioFileSourceSD → AudioFileSourceID3 → AudioGeneratorMP3 → AudioOutputM5CardputerSpeaker → M5Cardputer.Speaker (ES8311)

Installation

1. Install ESP8266Audio library via Arduino Library Manager
2. Format SD card as FAT32
3. Copy MP3 files to root directory
4. Upload code to Cardputer-Adv
5. Enjoy your music!

Credits

*Original Project:* VolosR/M5Mp3
*Adaptation:* AndyAiCardputer
*Hardware:* M5Stack Cardputer-Adv
*Audio Library:* ESP8266Audio by earlephilhower

Tags

arduino, esp32, m5stack, cardputer-adv, mp3-player, winamp, es8311, audio, retro, music-player, esp8266audio, freertos, sdcard, pcm, mono-audio, embedded-systems, diy-electronics, retro-computing, music-tech

---

*Like this project?* ⭐ Star it on GitHub!

*Questions or suggestions?* Open an issue on GitHub or leave a comment below!