Yet Another
Media Player

Warum zum Teufel?

Wir sitzen mindestens einmal die Woche mit einer Handvoll Leuten zusammen — essen, reden, spielen Schocken und hören Musik dabei.

Und letzteres ist manchmal ein bisschen anstrengend: Einer mag dieses nicht, eine mag jenes — und wenn der Sound vom Handy kommt, wird ständig dieses nervige Teil rausgekramt, die Brille rausgekramt und auf dem Schmierpad rumgetippt. Oder "Deine Röhre" kommt zum Einsatz — und die nervt mit Werbung. Und manchmal bricht ja auch im besten Deutschland aller Zeiten das Neuland weg.

Kurz: es stresst.

Also: bau einen MP3-Player, den man einfach auf die Box setzt — mit einem einzigen, für alle zugänglichen Button, mit dem man sofort jeden Song skippen kann. Einfach auf den dicken Button draufpatschen. Fertig.

Erste Versuche mit dem Heltec LoRa (weil's grad da war) stießen an Grenzen — da kam die ESP32-S3-DevKit-Variante dazu. Das OLED braucht man eh nicht; dann könnte man auch gleich ein Handy nehmen. Jetzt ist diese Variante im Einsatz, und den ersten Abenden hat sie bereits überstanden.

Eine 32-GB-Speicherkarte mit derzeit rund 1100 Titeln ist im Einsatz. Bis zu 5000 sollten problemlos gehen. Zwei beiliegende Scripts kümmern sich um die SD-Karte: rename_mp3.sh kopiert MP3s in die genormte Verzeichnisstruktur (mit Duplikaterkennung), make_index.py erzeugt danach die index.csv für den Player. Die Dateistruktur auf der SD-Karte sieht so aus:

SD:/
├── index.csv
├── history.csv        ← Wiedergabe-History (automatisch)
├── 01/
│   ├── 0001.mp3
│   ├── 0002.mp3
│   └── ...
├── 02/
│   └── ...
└── 99/
    └── 9999.mp3

Features

Bedienung

LED-Blinkmuster

Onboard-LED (alle Boards) zeigt den Betriebszustand. Der NeoPixel-Streifen (S3-DevKit) visualisiert zusätzlich die Lautstärke.

Lightshow

Hardware-Impressionen

Erster Aufbau mit ESP32-S3 DevKit

Erster Versuch — ESP32 WROOM mit China-Pilztaster, montiert auf Disco-Box

Aktueller Sandwich-Aufbau mit ESP32-S3 DevKit

Aktueller Sandwich-Aufbau mit ESP32-S3 DevKit

Sandwich von oben — KCX BT-Modul, PCM5102A DAC und SD-Karte auf ESP32-S3 DevKit

Nun muss ein Gehäuse her — schnell, einfach, passend, stabil und billig. Da war doch was …

Vorher — die dicken Sauerländer im Einsatz

Nachher — der große Button

Hardware

Drei Board-Varianten werden unterstützt. Nur eine Zeile in patsch.ino einkommentieren:
(Die letzten Versionen sind aber bislang nur mit dem S3-Devkit getestet worden. Eigenes Feedback gern an ralf@rbag.de)

// #define BOARD_HELTEC_LORA_V3
#define BOARD_ESP32_S3_DEVKIT
// #define BOARD_ESP32_WROOM

Software

Abhängigkeiten über den Arduino Library Manager installieren:

SD-Karte befüllen mit rename_mp3.sh:

# Dry-run (zeigt was passieren würde)
./rename_mp3.sh ~/Musik /media/SDCARD

# Wirklich kopieren
./rename_mp3.sh ~/Musik /media/SDCARD --run

# Mit Duplikatprüfung (Dateiränder vergleichen)
./rename_mp3.sh ~/Musik /media/SDCARD --run --diff-edges

# Vollständiger Byte-Vergleich (langsam aber sicher)
./rename_mp3.sh ~/Musik /media/SDCARD --run --diff-full

Danach Index generieren mit make_index.py:

# Index für die gesamte SD-Karte generieren
python3 make_index.py /media/SD --priority 5 -o /media/SD/index.csv

# Nur einen Ordner indizieren
python3 make_index.py /media/SD --include 04 -o /media/SD/index.csv

# Mit Priorität aus Ordnernamen (ambient=1 … hits=9)
python3 make_index.py /media/SD --genre-from-folder -o /media/SD/index.csv

# Vorschau ohne Schreiben
python3 make_index.py /media/SD --dry-run

Format der index.csv:

/01/0001.mp3,,5
/01/0002.mp3,,9
/02/0001.mp3,,3

Felder: Pfad, Genre (optional), Priorität 0–9

Format der history.csv (automatisch angelegt):

uptime_ms,pfad,priorität
183742,/01/0330.mp3,5
184891,/02/0007.mp3,3

Timestamp = akkumulierte Gesamtlaufzeit des Players in Millisekunden.

Flashen mit flash.sh:

# ESP32-S3 DevKit (Port automatisch erkannt)
./patsch/flash.sh s3devkit

# ESP32 WROOM
./patsch/flash.sh wroom

# Heltec LoRa v3
./patsch/flash.sh heltec

# Port explizit angeben
./patsch/flash.sh s3devkit /dev/ttyACM0

# Nur kompilieren, nicht flashen
./patsch/flash.sh --only-compile

Hinweis S3-DevKit: Beim ersten Flash ohne CH343-Adapter muss der Download-Modus manuell ausgelöst werden: BOOT gedrückt halten → kurz RESET → BOOT loslassen. Mit angeschlossenem CH343-Adapter (UART0) funktioniert das Auto-Reset normal.

WLAN & Webkonsole

Der ESP32-S3 DevKit spannt beim Start einen eigenen Access Point auf:

Unter http://192.168.4.1/ steht eine Browser-Konsole bereit: Konsolen-Log in Echtzeit (1s-Polling), Eingabefeld für alle seriellen Kommandos. Funktioniert parallel zur USB-Serial-Konsole.

Serielle Konsole

Über USB-Serial (Newline als Zeilenende) oder die Web-Konsole steuerbar:

Changelog