Skip to the content
2 layers116.8 × 53.9 mmSaxplayer, the printed circuit board in 3D

This is my own sample demo project for my tutorial to soon be posted on stasis! It is a simple mp3 player/streamer using a seeed, a headphone jack, an oled, and 3 buttons/keyswitches.

Size
116.8 × 53.9 mm
Copper layers
2
Thickness
1.6 mm
Parts
40
Nets
42
Pads
110
Tracks, vias
269, 32
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
26 Mar 2026
Updated
3 Sep 2026

Overview

Saxplayer is an open-source printed circuit board by tenorangesax, from the tenorangesax/The-SaxplayerTM repository on GitHub. It is a 2-layer board of 116.8 × 53.9 mm with 40 parts on 42 nets, routed with 269 tracks and 32 vias.

It is built around the ESP32-DEVKITC-VE. Its parts include 6 resistors, 5 capacitors, 4 switches, 2 connectors and 1 IC. It belongs with the audio and music and lEDs and displays boards and the ESP32 boards of this library.

Main components

1

README

README.md

The-Saxplayer™

The Saxplayer™ is a device that houses a ESP32E for the microcontroller, a OLED display to see what songs are playing, 3 MX-Style keyboard switches for navigation of songs, a rotary encoder switch for adjusting the volume and navigating menus, a micro sd card slot for storing your music, and a audio jack for headphones or output to speakers! Also has a cool case I made along with it!

FIRMWARE GUIDE AT BOTTOM!

WORKING VIDEO DEMO LINK!!!

FINAL SHOTS:

IMG_7619 IMG_7595

THE CASE:

IMG_7608 IMG_7609 IMG_7610

3D VIEWER:

Back_final Front_Final

THE SCHEMATIC: schematic

PCB EDITOR: the components

CASE MODELING: Screenshot 2026-04-18 at 4 40 20 PM Screenshot 2026-04-18 at 4 41 53 PM Screenshot 2026-04-18 at 4 41 45 PM Screenshot 2026-04-18 at 4 41 21 PM

BOM:

Item nameQuantitySingle priceLink to purchaseDescription
Cherry MX-compatible PCB switch3$0.40MechanicalKeyboardsKeyboard switch for the 3 keys
Micro SD card socket1$1.52PCBA assembled by JLCPCBMicroSD push-push SMT socket
1.3in 128x64 I2C OLED display1$5.27AmazonMonochrome OLED display
10k resistor4$0.02AmazonThrough-hole resistor
3.5mm audio jack1$1.52DigiKeyRight-angle SMT audio jack
10uF capacitor1$0.10AmazonPolarized capacitor
Rotary encoder with push switch1$4.90AmazonRotary input control
0.1uF capacitor2$0.05AmazonDecoupling capacitor
10uF capacitor2$0.10AmazonCapacitor
4.7k resistor2$0.02AmazonPull-up / signal resistor
ESP32 DevKitC board1$10.00AmazonMain controller board

Saxplayer™ Firmware (MicroPython)

WAV music player firmware for the Saxplayer board (ESP32-WROOM, SH1106/SSD1306 OLED, microSD, 3 MX switches, EC11 encoder, 3.5mm jack driven by the ESP32's internal DACs).

Flashing

  1. Install esptool and grab the latest ESP32 MicroPython firmware from micropython.org/download/ESP32_GENERIC/
  2. Flash it (adjust the port):
    text
    esptool.py --chip esp32 --port /dev/tty.usbserial-XXXX erase_flash
    esptool.py --chip esp32 --port /dev/tty.usbserial-XXXX write_flash -z 0x1000 ESP32_GENERIC-*.bin
  3. Copy this Firmware folder's .py files to the board with mpremote:
    text
    mpremote cp boot.py config.py inputs.py wavplayer.py main.py :
    mpremote mkdir lib
    mpremote cp lib/sh1106.py lib/ssd1306.py :lib/
    mpremote reset

Preparing music

Convert anything (MP3, FLAC, ...) to player readable WAV with ffmpeg, then drop it on the SD card (FAT32):

text
ffmpeg -i song.mp3 -ac 1 -ar 16000 -sample_fmt s16 song.wav

Mono, 16 kHz, 16-bit is prefered.

Controls

InputBrowserNow playing
SW1 (up)move upprevious track
SW3 (down)move downnext track
SW2 (select)playplay / pause
Encoder turnvolumevolume
Encoder pushrescan SDstop, back to browser

Files

  • config.py — every pin assignment and tunable, matches the KiCad netlist
  • inputs.py — IRQ-driven buttons + quadrature encoder decoding
  • wavplayer.py — WAV parsing and DAC playback (viper-optimized conversion)
  • main.py — SD mount, file browser, now-playing UI
  • lib/sh1106.py, lib/ssd1306.py — OLED drivers (1.3" panels are usually SH1106; switch with OLED_DRIVER in config.py)

Hardware errors (check before assembling!)

The rotary encoder's common pin (C) and switch return (S2) reach GND only through capacitors C4/C5. Capacitors block DC, so as designed the encoder can never actually pull GPIO13/14/27 low, so turns and pushes won't register.

It would already be bridged for you by me, but if not, bridge C4 and C5 with a solder blob/0Ω resistor.

Parts

40
QtyValueFootprintReferences
21LOGOLOGOG***, G***, G***, G***, G***, G***, G***, G***, G***, G***, G***, G***, G***, G***, G***, G*** +5
410kΩResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR1, R2, R5, R6
3SW_PushButton_Switch_Keyboard:SW_Cherry_MX_1.00u_PCBSW1, SW2, SW3
20.1uFCapacitor_THT:C_Disc_D3.0mm_W1.6mm_P2.50mmC4, C5
210µFCapacitor_THT:C_Disc_D5.0mm_W2.5mm_P5.00mmC1, C2
24.7kΩResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mm_HorizontalR3, R4
110µFCapacitor_THT:CP_Radial_D5.0mm_P2.00mmC3
1AudioJack3Connector_Audio:Jack_3.5mm_CUI_SJ-3523-SMT_HorizontalJ2
1ESP32-DevKitCPCM_Espressif:ESP32-DevKitCU1
1Micro_SD_Cardsd_card:J_SD_Card-micro_socket_AJ1
1OLED_128X64_1.3_I2COLED_128X64_1.3_I2C:LCD_OLED_128X64_1.3_I2CDS1
1RotaryEncoder_SwitchRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW4

Similar boards

  • 2 layers103.8 × 50 mmGalagino pcb set, the printed circuit board in 3D

    Galagino pcb set

    harbaum/galagino

    A Galaga, Pac-Man and Donkey Kong arcade emulator for the ESP32

    26 parts558
  • 2 layers115 × 75 mmSpinCoater, the printed circuit board in 3D

    SpinCoater

    RParkerE/OpenSilicon

    OpenSilicon enables DIY semiconductor fabrication with open-source guides for building IC equipment at home. The project includes BOMs, 3D files, firmware, and PDKs, supporting makers and researchers in chip fabrication.

    11 parts55GPL-3.0
  • 2 layers127.3 × 54.1 mmESP32 SolarBox, the printed circuit board in 3D

    ESP32 SolarBox

    cole8888/SRNE-Solar-Charge-Controller-Monitor

    Read data from SRNE solar charge controllers.

    34 parts42
  • 2 layers62.2 × 57.1 mmWs2mqtt, the printed circuit board in 3D

    Ws2mqtt

    Tho85/ws2mqtt

    Connect WiSafe2 devices to Home Assistant

    8 parts28BSD-3-Clause
  • 2 layers99.9 × 99.9 mmSplit flap, the printed circuit board in 3D

    Split flap

    tinkermax/split-flap

    DIY mechanical spli-flap display

    28 parts13CC-BY-4.0
  • 2 layersJF ECU32, the printed circuit board in 3D

    JF ECU32

    JoachimF/JF-ECU32

    RC Jet Engine ECU

    27 parts12GPL-3.0
  • 2 layers72.5 × 84.8 mmDevboard, the printed circuit board in 3D

    Devboard

    ste2425/PSP-Bluetooth-AVConnector

    An AV-Out Breakout library for the PSP. Providing Kicad symbols and footprints to interface with the PSP 2/3K AVOut socket (also known as the TVOut socket)

    13 parts12
  • 2 layers100 × 88.9 mmGen2, the printed circuit board in 3D

    Gen2

    Alignof/Juggernaut

    疑似時限爆弾解除競技

    41 parts10MIT

Questions

How big is the Saxplayer PCB?

It measures 116.8 × 53.9 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Saxplayer use?

40 parts, built around the ESP32-DEVKITC-VE. 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 Saxplayer KiCad files?

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

Can I use the Saxplayer design in my own project?

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