$ show schreibfaul1/ESP32-MiniWebRadio
This repository contains firmware for an ESP32-based internet radio with a color TFT touchscreen display. It implements a full-featured audio player supporting internet radio streaming (MP3, AAC, FLAC, etc.), local SD card playback, DLNA/UPnP browsing, Bluetooth audio output via a KCX emitter, and an alarm clock with weather display. The system is controlled via a touchscreen GUI, IR remote, or a web interface with WebSocket real-time communication. It also includes an FTP server for SD card file management. The architecture is a monolithic embedded application built on Arduino/ESP-IDF with PlatformIO, featuring a custom display library (tftLib) with LVGL-based fonts, a web server library, DLNA client, and various hardware drivers. The codebase is well-structured with reusable library components, though it exhibits some technical drift such as manual protocol parsers, mixed language comments, and future-dated file headers.
The LLM identified 5 files worth highlighting for reuse:
Implements a lightweight HTTP and WebSocket server for ESP32. Handles GET/POST requests, chunked file streaming, file uploads, and WebSocket command/control. Uses a non-blocking state machine pattern with per-call bounded transfers. The server is self-contained and can be reused in other ESP32 projects needing a web interface.
A DLNA/UPnP client that discovers media servers via SSDP, browses content using SOAP requests, and parses XML responses. Implements a state machine (IDLE, SEEK_SERVER, GET_SERVER_ITEMS, BROWSE_SERVER) for non-blocking operation. The client is reusable for any ESP32 project requiring UPnP media browsing.
A minimal FTP server implementation for ESP32 that provides file access to an SD card. Handles control and data connections, supports LIST, RETR, STOR, DELE, and other standard FTP commands. The implementation is self-contained and can be extracted for other embedded projects needing FTP access.
Decodes NEC IR remote control signals using GPIO interrupts and a state machine. Handles repeat codes and provides a callback interface for button presses. The decoder is hardware-independent (only requires a GPIO pin) and can be reused in any ESP32 project with an IR receiver.
A client for the Open-Meteo weather API that fetches current and forecast data (temperature, precipitation, wind, moon phase). Parses JSON responses and provides structured data via a callback. The client is reusable for any ESP32 project needing weather data.