Skip to the content
4 layers41 × 90.2 mmAeropod2, the printed circuit board in 3D

An esp32 based mp3 player with the ability to play video too.

Size
41 × 90.2 mm
Copper layers
4
Thickness
1.6 mm
Parts
67
Nets
89
Pads
379
Tracks, vias
894, 147
Pours
3
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
17 Jul 2026
Updated
27 Aug 2026

Overview

Aeropod2 is an open-source printed circuit board by eyendamuri, from the eyendamuri/aeropod repository on GitHub. It is a 4-layer board of 41 × 90.2 mm with 67 parts on 89 nets, routed with 894 tracks and 147 vias.

It is built around the ESP32-WROOM-32, MPR121QR2 and MT3608, with the AMS1117-3.3, PCM5102APW and TP4056-42-ESOP8 among its other parts. Its parts include 27 capacitors, 17 resistors, 7 ICs, 5 diodes and 5 connectors. It belongs with the ESP32 boards of this library.

Main components

6

README

README.md

aeropod

A handheld music player built from scratch: custom hardware, custom firmware, custom everything.

aeropod is an iPod-inspired portable media player built around an ESP32. It has a capacitive click wheel, a 240×320 colour display, and plays music three different ways: local files from a microSD card, Spotify (both as a Spotify Connect speaker and through the Web API), and as a Bluetooth speaker over A2DP. It even plays MJPEG video. Everything runs on a custom 4-layer circuit board I designed, inside a 3D-printed case.

aeropod


What it does

  • Local playback: MP3 / AAC / WAV streamed off a microSD card, browsed by Artist → Album → Track
  • Spotify: log in once on your phone, then control playback and stream straight to the device. aeropod also announces itself as a Spotify Connect target, so you can pick it as a speaker from the Spotify app
  • Bluetooth audio works both ways: use aeropod as a Bluetooth speaker (A2DP sink) from your phone, or have it stream out to Bluetooth headphones (A2DP source). AVRCP play/pause/skip supported in both directions
  • Video: software MJPEG decoding at 240×320, ~10-15 fps, with a synced PCM audio track
  • Click wheel: a real capacitive touch wheel (MPR121) on its own daughterboard, plus five mechanical buttons, just like the classic
  • iPod-style UI: stack-based screen system, scrolling menus, now-playing view, a status bar with battery and clock, redrawn at ~33 fps

UI


Hardware

aeropod is two custom PCBs plus a 3D-printed enclosure.

SubsystemPartNotes
MCUESP32-WROOM-32dual-core, Wi-Fi + Classic Bluetooth
DisplayST7789 240×320 SPI IPS LCDPWM backlight
Audio DACPCM5102A32-bit I²S stereo DAC
Touch inputMPR12112-zone capacitive click wheel
Buttons5× tactileMenu / Prev / Next / Play / Center
StoragemicroSD (SPI)FAT, holds the music library
PowerUSB-C → TP4056 charger → LiPo → AMS1117-3.3V + MT3608 boost

Main board: 4-layer, ~41 × 90 mm, 67 components, 147 vias. Click wheel board: the rounded daughterboard that carries the capacitive ring and buttons.

Pin map

PeripheralPins
ST7789 displaySCK 18, MOSI 23, CS 5, DC 17, RST 16, BL 27
microSD (shared SPI bus)CS 15
PCM5102A I²SBCK 26, LRCK 25, DATA 22
MPR121 click wheel (I²C)SDA 21, SCL 4, IRQ 13
ButtonsMENU 34, PREV 35, NEXT 32, PLAY 33, CENTER 39

PCB

Case


How the firmware works

The firmware is written in C on ESP-IDF v5.2+, about 7,300 lines across a dozen modules. It's organised so each subsystem (audio, video, Spotify, Bluetooth, storage, UI) is self-contained.

Boot sequence: NVS → display + splash → click-wheel/buttons → SD mount + library scan → audio player → video player → Wi-Fi → Spotify → Bluetooth → UI.

Task / core layout:

CoreTaskJob
0ui_task33 fps render + input dispatch
0mpr_ringMPR121 click-wheel IRQ processing
0cw_btnmechanical button polling
1player_taskMP3 decode (minimp3) + I²S output
0http_fetchHTTP audio stream fetch
0sp_connectSpotify Connect mDNS + polling

Spotify uses OAuth 2.0 PKCE device-code login (you authorise on your phone, tokens are saved to NVS and auto-refresh), the Spotify Web API over HTTPS for browse/search/ playback control, and a Spotify Connect receiver that announces over mDNS and decodes the audio stream to the I²S DAC.

Bluetooth uses the ESP32's Classic BT (BR/EDR) stack with A2DP for audio and AVRCP for transport controls, running alongside Wi-Fi via software coexistence.


Repository layout

text
aeropod/
├── aeropod_firmware/        ESP-IDF firmware (C)
│   ├── main/
│   │   ├── audio/           I²S output + MP3/AAC/WAV player
│   │   ├── bt_audio/        Bluetooth A2DP sink/source + AVRCP
│   │   ├── drivers/         display (ST7789), click wheel (MPR121), fonts
│   │   ├── network/         Wi-Fi manager + HTTP streaming
│   │   ├── spotify/         OAuth PKCE, Web API, Spotify Connect
│   │   ├── storage/         microSD + in-memory media library
│   │   ├── ui/              screen stack + screens (menus, now-playing...)
│   │   ├── video/           MJPEG player (TJpgDec)
│   │   ├── config.h         all hardware pin assignments
│   │   └── main.c           boot + app_main
│   └── BUILD.md             full build instructions
├── aeropod2/                main board - KiCad 10 project + 3D model
│   ├── gerbers/             fabrication gerbers + drill files
│   └── production/          bom.csv, positions.csv (pick & place), JLC-ready zip
├── clickwheel/              click-wheel board - KiCad 10 project + 3D model
│   ├── gerbers/             fabrication gerbers + drill files
│   └── production/          bom.csv, positions.csv (pick & place), JLC-ready zip
├── case/                    printable enclosure - .f3d source, .step, .stl
├── ASSEMBLY.md              how it all goes together
├── bom.csv                  full bill of materials with prices and links
└── aeropod case (Assembly).step   full case assembly model

Fabrication and assembly

Everything needed to physically build an aeropod is in the repo:

  • Gerbers: aeropod2/gerbers/ and clickwheel/gerbers/ (drill files included)
  • Pick and place: positions.csv in each board's production/ folder, plus a ready-to-upload JLCPCB package (aeropod2.zip / clickwheel.zip)
  • Case: case/Aeropod_Case.step, case/Aeropod_Case.stl, and the editable Fusion 360 source case/Aeropod_Case.f3d
  • Instructions: see ASSEMBLY.md for the step-by-step assembly plan

Bill of materials

Full machine-readable version with links in bom.csv. Prices are approximate and were checked in August 2026.

PartDescriptionQtyUnitTotalBuy
Main board (aeropod2)4-layer PCB, 41 x 90 mm, fabricated and assembled, min order 55$23.60$118.00JLCPCB
Clickwheel board2-layer PCB, fabricated and assembled, min order 55$7.60$38.00JLCPCB
ST7789 display module2 inch IPS LCD, 240x320, SPI1$15.99$15.99Waveshare
LiPo battery3.7 V single cell, 1000 mAh, JST-PH1$8.99$8.99Adafruit
microSD card32 GB, Class 101$7.99$7.99Amazon
FFC ribbon cable18 pin, 1.0 mm pitch, same-side contacts1$6.99$6.99Amazon
Earbuds or small speaker3.5 mm earbuds, or 8 ohm speaker1$5.99$5.99Amazon
Hot glue gun and sticksMounting the main board and battery, closing the case1$9.99$9.99Amazon
Cardstock sheetBacking behind the click-wheel board1$4.99$4.99Amazon
3D printed casePrinted through Hack Club's Printing Legion1$0.00$0.00Printing Legion
$217.92

The parts placed on the two boards (ESP32-WROOM-32, PCM5102A, MPR121, CP2102N, TP4056, AMS1117, MT3608, connectors, and passives) are covered by the assembly cost above. They are itemised with individual prices and LCSC links in bom.csv in case you want to source them yourself and hand solder.


Building the firmware

Full instructions are in aeropod_firmware/BUILD.md. Short version:

bash
# Requires ESP-IDF v5.2+ and an ESP32
. $IDF_PATH/export.sh

cd aeropod_firmware
idf.py set-target esp32
idf.py build
idf.py -p /dev/ttyUSB0 flash monitor   # COMx on Windows

Two third-party decoders are downloaded during setup rather than committed here (see BUILD.md): minimp3 (MP3) and TJpgDec (JPEG/video). For Spotify, register a free app at the Spotify developer dashboard and drop your Client ID into config.h (or enter it at runtime in Settings).


Parts

67
QtyValueFootprintReferences
14100nFCapacitor_SMD:C_0402_1005MetricC1, C2, C3, C7, C8, C9, C10, C14, C21, C22, C28, C29, C30, C31
510uFCapacitor_SMD:C_0805_2012MetricC4, C23, C25, C26, C27
310kResistor_SMD:R_0201_0603MetricR4, R5, R11
32.2uFCapacitor_SMD:C_0603_1608MetricC17, C18, C19
3D_SchottkyDiode_SMD:D_SOD-123D3, D4, D5
20.1uFCapacitor_SMD:C_0402_1005MetricC5, C6
21kResistor_SMD:R_0201_0603MetricR2, R3
22.2nFCapacitor_SMD:C_0402_1005MetricC15, C16
24.7kResistor_SMD:R_0201_0603MetricR7, R8
2470Resistor_SMD:R_0201_0603MetricR9, R10
25.1kResistor_SMD:R_0201_0603MetricR12, R13
2LEDLED_SMD:LED_0603_1608MetricD1, D2
2SW_Push_SPDTButton_Switch_THT:SW_E-Switch_EG1271_SPDTSW1, SW2
11.2kResistor_SMD:R_0201_0603MetricR1
1130kResistor_SMD:R_0402_1005MetricR17
122.1kResistor_SMD:R_0201_0603MetricR14
122uFCapacitor_SMD:C_0402_1005MetricC11
14.7uHInductor_SMD:L_0805_2012MetricL1
147.5kResistor_SMD:R_0201_0603MetricR15
1600 @ 100 MHzResistor_SMD:R_0603_1608MetricFB1
1750kResistor_SMD:R_0402_1005MetricR16
175kResistor_SMD:R_0201_0603MetricR6
1AMS1117-3.3Package_TO_SOT_SMD:SOT-223-3_TabPin2U2
1AudioJack3_GroundConnector_Audio:Jack_3.5mm_CUI_SJ-3523-SMT_HorizontalJ4
1Battery_CellConnector_JST:JST_PH_S2B-PH-SM4-TB_1x02-1MP_P2.00mm_HorizontalBT1
1CP2102N-Axx-xQFN20footprints:QFN20_CP2102N_SILU6
1Conn_01x07Connector_PinHeader_2.54mm:PinHeader_1x07_P2.54mm_VerticalJ6
1Conn_01x18Connector_FFC-FPC:TE_1-84953-8_1x18-1MP_P1.0mm_HorizontalJ2
1ESP32-WROOM-32RF_Module:ESP32-WROOM-32U3
1MPR121QR2Package_DFN_QFN:UQFN-20_3x3mm_P0.4mmU4
1MT3608Package_TO_SOT_SMD:SOT-23-6U7
1Micro_SD_CardConnector_Card:microSD_HC_Hirose_DM3AT-SF-PEJM5J5
1NetTie_2NetTie:NetTie-2_SMD_Pad0.5mmNT1
1PCM5102APackage_SO:TSSOP-20_4.4x6.5mm_P0.65mmU5
1TP4056-42-ESOP8Package_SO:SOIC-8-1EP_3.9x4.9mm_P1.27mm_EP2.41x3.3mm_ThermalViasU1
1USB_C_Receptacle_USB2.0_14PConnector_USB:USB_C_Receptacle_CNCTech_C-ARA1-AK51XJ1

More from eyendamuri/aeropod

1
  • 2 layers44.6 × 27.1 mmClickwheel, the printed circuit board in 3D

    Clickwheel

    eyendamuri/aeropod

    An esp32 based mp3 player with the ability to play video too.

    6 parts

Similar boards

  • 2 layers150.5 × 94 mmRx module, the printed circuit board in 3D

    Rx module

    koushik12328/Smart_mining_helmet

    An ESP32-powered safety helmet featuring gas detection, impact sensing, and IoT connectivity

    30 partsMIT
  • 2 layers80 × 100 mmPiQuest, the printed circuit board in 3D

    PiQuest

    qwel-exe/PiQuest

    54 parts
  • 2 layers52.8 × 68.5 mmMP3, the printed circuit board in 3D

    MP3

    amkhan2009/GameBoy-Mp3-Plater

    Portable ESP 32 based MP3 Player

    40 partsMIT
  • 2 layers86 × 109.7 mmKiki player, the printed circuit board in 3D

    Kiki player

    alaotach/kiki-player

    46 parts2
  • 2 layersUnplugged, the printed circuit board in 3D

    Unplugged

    Kalash4152/smart-dustbin-round-two

    Designed and simulated a Smart Dustbin & Smart Traffic Lights system using Arduino, ESP32, and sensors at DJSCE Unplugged 2.0.

    24 parts1
  • 2 layers49.4 × 95.7 mmPhysiowand, the printed circuit board in 3D

    Physiowand

    1tsMS/Physiowand

    91 parts
  • 2 layers61 × 61 mmESP32 FC, the printed circuit board in 3D

    ESP32 FC

    MAATHES-THILAK-K/ESP32-S3_FLIGHT_CONTROLLER

    A custom-designed flight controller based on the ESP32-S3 module, built for compatibility with the esp-fc firmware and Betaflight-like configuration.

    69 parts7Apache-2.0

Questions

How big is the Aeropod2 PCB?

It measures 41 × 90.2 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Aeropod2 use?

67 parts, built around the ESP32-WROOM-32, MPR121QR2, MT3608 and AMS1117-3.3. 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 Aeropod2 KiCad files?

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

Can I use the Aeropod2 design in my own project?

Its repository states no licence, so its author keeps all rights: ask eyendamuri before reusing the design.