Opens in a new tab

Internet radio receiver with ESP32. Complete guide including 3D printing. Home Assistant support included.

News2025-09-23
Author: Petr Šrámek

In short: YoRadio is an open-source internet radio built around an ESP32 WROOM with the ESP32-audioI2S library. The complete project includes firmware, two PCB designs, a 3D-printable enclosure on Printables, and Home Assistant integration via MQTT. Audio output uses either an I2S DAC (UDA1334) or a VS1053b decoder shield. It supports a wide range of displays – TFT, OLED, 16×2 character LCD, or Nokia 5110 – plus encoders and buttons. Build it with Arduino IDE 1.8.19 (not 2.x) and ESP32 core 2.0.0 or higher.

Internet radio receiver with ESP32
Internet radio receiver with ESP32

The YoRadio project is an open-source internet radio built on the Wi-Fi and Bluetooth chip ESP32 with the ESP32-audioI2S library. It features complete documentation, a wide range of supported displays, and can be controlled via MQTT (suitable for Home Assistant).

I stumbled upon this project while browsing printables. I was impressed by how good it looks, and all the materials – PCB, code, and 3D print files are freely available, plus the entire project is well documented. It also includes integration into Home Assistant.

As I mentioned, the entire project is based on the ESP32 – a classic ESP32 WROOM development board (laskakit)
Additionally, you will need an I2S DAC UDA1334 (botland), and one of the available VS1053b modules – for example, this shield (laskakit, botland).

Internet radio receiver with ESP32 and 3D print
Internet radio receiver with ESP32 and 3D print

Then optionally one of the many supported displays – TFT, OLED, 16×2, or Nokia 5110 display. To perfect it, you will also need to purchase buttons, a joystick, an encoder, and other small parts – you can find them on the project’s GitHub.

Just be careful of these two pitfalls!
Arduino IDE version 2.x.x is not supported. Use Arduino IDE 1.8.19
ESP32 core version 2.0.0 or higher is required!

Project Wiki https://github.com/e2002/yoradio/wiki

Project GitHub https://github.com/e2002/yoradio

3D print https://printables.com/model/1215555-internetradio-yoradio-esp32

PCB (two available versions) https://github.com/e2002/yopcb

The project is still active, and further improvements are being implemented. Another great advantage is the support for add-ons that you can use to enhance this interesting project.

Radio from a 3D printer
Radio from a 3D printer

You are asking

What hardware do I need to build YoRadio?

Core hardware: an ESP32 WROOM development board, an audio output (I2S DAC like UDA1334 or a VS1053b shield), and one of the supported displays – TFT, OLED, 16×2 LCD, or Nokia 5110. To round it out you'll want buttons or a rotary encoder for control, optionally a joystick. Two pre-made PCBs are available on the project's GitHub if you don't want to wire it on a breadboard.

Can I control YoRadio from Home Assistant?

Yes – YoRadio communicates over MQTT, which makes integration with Home Assistant straightforward. You can control playback (play/pause, volume, station selection) from any HA dashboard or automation, and the radio reports its current state back. The MQTT broker setup is documented in the project's wiki.

What's the easiest way to flash the firmware?

Two pitfalls to avoid: don't use Arduino IDE 2.x – it's not supported, you need Arduino IDE 1.8.19. And the ESP32 core must be version 2.0.0 or higher. Once you have the right toolchain, the project's wiki on GitHub walks through library installation, pin configuration for your chosen display, and Wi-Fi setup.

Is there a 3D-printed enclosure available?

Yes, fully – the project provides STL files for a 3D-printable enclosure on Printables (model 1215555), two PCB designs on GitHub, complete source code, the firmware wiki, and addons for extending functionality. Everything from buttons to encoder wiring is documented, and the project is still actively developed.
Share the article:
Show your
Maker soul!
Buy a T-Shirt
Coffee for Chiptron
Give a boost to the next article

Related Articles

ESP32 Plane Radar: Aircraft radar on your desk for a few hundred crowns

News2026-06-24

If you’ve ever wondered what plane is flying over your house, you’ve probably used an app like FlightRadar24. The ESP32 Plane Radar project offers a more interesting solution though – your own desktop radar built on ESP32 that displays planes…

ESP32 Chip Comparison: Which to Choose for Your Project

Articles2026-05-25

ESP32, S2, S3, C3, C6, H2, C5, P4 and the upcoming S31 – which chip to choose for your project? Comparative peripherals table, use-case decision tree, software platforms overview, and tips on where to buy dev boards in Czechia.

Native Linux on ESP32-S3 – No Emulation, Directly with 9.7″ E-Paper

News2026-09-14

Linux 6.11 runs directly on the Xtensa core of the ESP32-S3 without emulation. After login, the shell mirrors to the 9.7″ ED097TC2 e-paper display.

Weather radar and aircraft radar on one round display

Articles2026-09-16

MeteoPlaneRadar 0.7.0: aircraft radar, weather radar, forecast, spot electricity price and the grid mix on a round 2.1″ display. Flashed from a browser.

Home RADAR? AERIS-10 with a range of up to 20 km.

Aeris-10
News2026-04-14

When radar is mentioned, most people picture a metal dish on an airport roof or a giant military installation surrounded by barbed wire. The AERIS-10 project (short for Array Electronic Radar with Integrated System) is embarking on the development of…

We program ultra-low-cost microcontrollers CH32V00x both in Arduino IDE and without it (Linux). Guide.

Articles2025-09-08

CH32V microcontrollers – you’ve probably heard of them. They are sold at a ridiculously low price but come with a very decent set of features, plus they are available in a solder-friendly package. Among the peripherals, you’ll find not only…

Trends