WiFi Webradio on ESP8266 or ESP32

A fully featured wifi web radio player with only low cost boards.
with or without a vs1053 board

Similar projects worth following
Control with any browsers (ie edge, chrome mozilla etc...).
or with an external hardware panel or with the uart interface or with telnet.
Memory for 255 stations
OTA (On the Air) upgrade,
Read direct mp3 or ogg or WMA streams or playlist .pls .m3u, asx and .xspf
Read up to a 320 kb/s stream,
Encoder, IR, lcd ...
Embedded wifi configuration via the web or serial or telnet.
Metadata displayed (ie Title of the current song if given in the stream),
Permanent setting (sound setting, stations, wifi)
Server multi clients with automatic refresh (websocket),
The stations may be downloaded and uploaded within the web site,
Stations sort management by drag drop.
very quick responsive web by caching local information in the browser and websocket.
additional hardware: a led indicates the state of the equipment
Optional: control switches, lcd display, additional ram for buffering

See for the description of the minimal prototype.

See Github for sources

See github source for the ESP32 version ( vs1053 or i2s or pcm or internal DAC)

See A project derived from KaRadio32 in progress.

See the lcd +IR software's on Github AddOn

See some realizations of users at KaraDio

A nextion touchscreen display for KaraDio from yo2ldk : Here

For more informations or questions, you can enter to the Karadio facebook group

KaRadio32 Release 1.9


Release 1.9 Rev6 - Built on 2020/01/11


  • 1.9 R7
    • New telnet or serial commands: cli.wake, cli.sleep:
      cli.wake("x"): x in minutes. Start or stop the wake function. A value 0 stop the wake timer cli.sleep("x"): x in minutes. Start or stop the sleep function. A value 0 stop the sleep timer cli.wake: Display the current value in seconds cli.Sleep: Display the current value in seconds
    • sys.lcdstop, sys.lcdblv: sys.lcdstop and sys.lcdstop("x"): Timer in seconds to switch off the lcd on stop mode. 0= no timer sys.lcdblv and sys.lcdblv("x"): Value in percent of the backlight.
    • Fade in and out for backlight driven by a gpio.
    • New tool and hardware partition from Bazooka07: Update for boards/ use tool directly from $IDF_PATH folder can process one or all boards in one shot. Update size for binary partition : 0x3000 now ! Look at :
    • Decode url correctly for /webStation. included name #149
    • Esp-idf Release 3.3.1
  • 1.9 R6:
    • Parse playlist fix.
  • 1.9 R4:
    • command now disable the AP mode if already connected to an AP in the past.
    • I2S corrected for 32bit output stream. Thanks to har-in-air github user.
    • Instant play: new button "Add/Edit", and update fields on cli commands.

KaRadio: Release 1.9

Release 1.9 R6 - Built on 2020/01/11


  • 1.9 R6:
    • Parse playlist fix.
  • 1.9 R4:
    • LWIP layer tuned. Better errno 11 computing.



For ESP32 see the github page KaRadio32. Release 1.6 R4

ESP8266 Simplest prototype:

- Optional external ram (23LCV1024) support (1:CS/=GPIO16 2:MISO=GPIO12 3:NC 4:GND 5:MOSI=GPIO13 6:SCK=GPIO14 7:GND 8:3.3v)

The optional led is now on GPIO2. The blue led on the ESP8266 is blinking at the same rate.
GPIO16 is now the Chip select for the external ram if any.
The external ram is detected at boot time if present.

To upgrade to this release, please flash at 0x1000 , at 0X81000 and blank.bin at 0x7e000 & 0x3fe000
After that, all next updates are done with the On The Air (OTA) feature.
New binaries are hosted at .

Loading the esp8266

First use

  • If the access point of your router is not known, the webradio initializes itself as an AP. Connect your wifi to the ssid "WifiWebRadio",
  • Browse to to display the page, got to "setting" "Wifi" and configure your ssid ap, the password if any, the wanted IP or use dhcp if you know how to retrieve the dhcp given ip (terminal or scan of the network).
  • In the gateway field, enter the ip address of your router.
  • Validate. The equipment restart to the new configuration. Connect your wifi to your AP and browse to the ip given in configuration.
  • Congratulation, you can edit your own station list. Don't forget to save your stations list in case of problem or for new equipments.
  • if the AP is already know by the esp8266, the default ip at the first start is
  • a sample of stations list is on
Read more »


KaRadio32 1.9 Rev 7 Updated

octet-stream - 1.43 MB - 02/14/2020 at 22:20


KaRadio 1.9 Rev 6 Partition 1

octet-stream - 421.50 kB - 01/11/2020 at 18:13


KaRadio 1.9 Rev 6 Partition 2

octet-stream - 421.50 kB - 01/11/2020 at 18:13


octet-stream - 3.98 kB - 09/17/2017 at 10:26


octet-stream - 4.00 kB - 07/21/2016 at 15:19


View all 6 files

View all 6 components

View all 11 project logs

  • 1
    Step 1


    From ESP8266_ESP12( 3.3 v) or nodeMCU(5v) to VS1053 (5 v)


    ADC : gound if control panel not used

    CH_PD to 3.3v

    GPIO16 led output

    D5:GPIO14 to VS1053 SCK

    D6:GPIO12 to VS1053 MISO (or so)

    D7:GPIO13 to VS1053 MOSI (or si)

    TXD to CH340G UART rx

    RXD from CH340G UART tx

    D1:GPIO05 to VS1053 XDCS

    D2:GPIO04 to VS1053 DREQ

    D3:GPIO00 to VS1053 XRST


    D8:GPIO15 to VS1053 XCS

View all instructions

Enjoy this project?



TheotherMike wrote 05/06/2018 at 09:31 point

Dear JP,

I have an ESP32-WROOM on my desk and want to built your radio.

Unfortunately, I cannot find the "build/karadio32.bin" in your github!? 

Where are the install binaries located ?

Thank you in advance,


  Are you sure? yes | no

Thomas wrote 03/21/2018 at 08:19 point

Hello JP,

are there any known stability issues in 1.6.3?

I tried to build a new  Karadio and after updating  to 1.6.3 i have bootloops.

Tried on different modules. After Reflashing back to 1.0.8 it works stable.

Any Idea?



  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 03/21/2018 at 08:23 point

From 1.0.8 to 1.6.3, it is a big jump. I think that it will be useful to erase all the flash eprom, all 4MB.

  Are you sure? yes | no

Thomas wrote 03/21/2018 at 09:25 point

I have the binaries 1.0.8 laying around. And ever i build a new karadio i flash them and than i update via the Webinterface Update button.

But you're right. It is a big Jump. I will download new binaries from your Github, erease the whole flash and try again.

Flash Pattern is still identical?

1. Boot

2. User1

3. User2

4. blank

5. blank

6. default

7. default



  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 03/21/2018 at 12:38 point

The saved data structure is not compatible with the old one.
<try to erase all.

  Are you sure? yes | no

Kabron wrote 03/11/2018 at 07:08 point

I configured addon.h and gpio.h as following:

#define LCD_COLOR 128 //0x80
#define LCD_SPI 194 //0x40
#define LCD_I2C 0
#define LCD_NONE 255

#define PIN_LCD_CS GPIO_NUM_14 //CS
#define PIN_LCD_A0 GPIO_NUM_27 //A0 or D/C
#define PIN_LCD_RST GPIO_NUM_33 //Reset RES RST or not used`

compiled OK, stations receive OK
##LCD is 194#
but after start I see very very slowly LCD filling with light blue and nothing more.

  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 03/11/2018 at 08:35 point

Your mistake is on addon.h. It must not be changed.
#define LCD_SPI            64 //0x40

The lcd type is set by sys.lcd command.

  Are you sure? yes | no

Kabron wrote 03/11/2018 at 10:57 point

Thank you for fast reaction.

I corrected it with no result. Additional test results I putted on github page.

  Are you sure? yes | no

Slovator wrote 03/03/2018 at 15:17 point

Is it possible to add a radio on / off function at the specified time in the project on ESP32?

  Are you sure? yes | no

wlads wrote 02/24/2018 at 13:34 point

Thank you for the project.

I do not have enough cyrillic fonts, please add

  Are you sure? yes | no

pilnikov wrote 02/06/2018 at 14:51 point

Hello JeanPierre. Thank you very much for your great useful work for us. I want to modify my radio (add the WEB function to it) So I had an little idea about it, maybe she is not new, of course, but I decided to share it with you. My radio on the side can play files from USB, Micro SD, Bluetooth and AUX. Also my radio have a Ir RC. Aliexpress sells many similar low cost modules.  The idea of controlling my radio by 1 wire (through Ir line) - by small means we get more opportunities. 

How do you like this?

  Are you sure? yes | no

mauro.venturelli wrote 01/21/2018 at 11:10 point

Hello JeanPierre, first of all ,thanks for the beautiful project.

I've built one (KaRadio-32 with integrated addons) and an LCD ILI9341 194 // 240x320

Everything working fine but the image is shifted to right by abt 20 pixels,any possibility of fixing it ?



  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 01/21/2018 at 12:57 point

Look at the lcd switched off. You will see that it is the lcd itself with a black array on left.

  Are you sure? yes | no

petitjp wrote 01/18/2018 at 20:35 point

bonjour Jean-Pierre 

Je m'appelle aussi Jean-Pierre : j'ai 66 ans et j'aurai besoin de votre aide pour adapter votre système pour ma mère de 86 ans... elle écoute France Inter en WiFi mais elle devient très vous dis quoi (je suis chti) par Mel : mode Ip. Merci

  Are you sure? yes | no

Eugene wrote 12/21/2017 at 14:18 point

Hello Jean-Pierre, thank you very much for your wonderfull project. I have some problem with lcd display ( ili9341) initialization . I can see just:


(c) Karawin

IR+clcd V1.1


and nothing more. I use arduino pro mini + lcd ili 9341 + karadioUCglib. Uart speed 28800 same on arduino and esp 12f. (ucglibConf: Ucglib_ILI9341_18x240x320_SWSPI ucg(/*sclk=*/ 7, /*data=*/ 6, /*cd=*/ 5 , /*cs=*/ 3, /*reset=*/ 4); ) All worked on 5110 lcd. but i haven't it now. Can you help please? 

ps: sorry for my english =-)

  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 01/21/2018 at 13:01 point

Probably a problem of uart if nothing seems received. I don't have a prototype to test it.

  Are you sure? yes | no

koka5675766 wrote 12/09/2017 at 07:27 point

Hello. At me the offer to the author, to add the timer of inclusion and deenergizing on time.

  Are you sure? yes | no

vis22 wrote 11/01/2017 at 17:28 point

Hello, for quality sound it is important to know the level of wi-fi signal. Is there a possibility to bring the level indicator wi-fi access the management page of Karadio.

  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 11/01/2017 at 18:05 point

I tried some time ago, but it broke somethings. I agree that it is a good feature. I will try again.

Done in 1.6.2

  Are you sure? yes | no

vis22 wrote 11/02/2017 at 20:35 point

Many thanks for your promptness. Updated to 1.6.2, the wi-fi indicator is working.

  Are you sure? yes | no

Thomas wrote 09/03/2017 at 12:33 point

Hi JP, i have a big problem. After upgrading from 1.1.7 to 1.6 I have no sound anymore. The slider for loudness goes from minus 127 to 0. Is there a change from a variable to a signed type? I tried to enable the patch as well but no success. Any further Idea what to try?

Thanks a lot and have a nice Sunday


  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 09/03/2017 at 13:04 point

It seems that your vs1053 doesn't like the vs patch. To disable it on the uart interface or with telnet type the command
and reset the esp8266<

The slider in db is from -127db to 0db

  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 09/03/2017 at 13:11 point

Or may be another problem on wire because it is the only cause i can imagine. See the log on the serial at the beginning to see if the vs is well detected.

  Are you sure? yes | no

Thomas wrote 09/11/2017 at 06:55 point

Hi JP, it seems to be a defect in Flash memory.

I tried several things. A reflash ended in a blinking Pattern twice a second and no serial output. So i assume the flash is dead. I replaced the ESP8266 board and now it runs good again.



  Are you sure? yes | no

satos wrote 08/27/2017 at 13:26 point

Hi,I like your projekt very much.
Now i have a little problem with the OLED Display.
Sometimes it loses connection to ESP and the Text  becomes  static.
I use a Wemos D1 mini and the Arduino ATmega 328 mini pro 8Mhz 3.3V to
drive the OLED. I also use IR and the Switches.
When i set the uart speed again (sys.uart("28800") it works
for some time, only the displayed Ip at startup is then But Sound is ok and the "real" IP is also reachable with the Browser.
I work with Version 1.6 and i believe it worked better with 1.4 in my Case. Any Ideas?

  Are you sure? yes | no

jan wrote 08/22/2017 at 18:04 point

Is it possible to make a soft reset from the ardruino 

  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 08/22/2017 at 20:08 point

from the arduino? I don't have an arduino on this project apart the addon for lcd and controls. Anyway, to send a reboot on the serial, the command is

  Are you sure? yes | no

ernie 881 wrote 06/09/2017 at 14:59 point

I personally think that the red VS1053B modules e. g. are much better than the blue ones labeled "lcsoft studio" or "lc technology". These were or damaged at arrival or dead after a few hours and don't have pin 34 pulled down (mp3 enabled at startup see ).

  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 06/13/2017 at 20:19 point

I own all models lcsoft, red one and alientek (more complete than other) and all play for month now without problem.

The pin 34 is not a problem with the software patch.

  Are you sure? yes | no

ldv82 wrote 05/30/2017 at 13:44 point

Most likely, this depends on the compatibility of VS1053 and DAC. You will use an external DAC instead of the built-in VS1053.

  Are you sure? yes | no

Jean-Pierre Cocatrix wrote 05/30/2017 at 16:37 point

I am not an expert on DAC. All I know is:
##I2S speed: 0, 0=48kHz, 1=96kHz, 2=192kHz#
from the vs1053.

  Are you sure? yes | no

brony wrote 05/20/2017 at 04:53 point

Hi. Could you implement so called "radio buttons" to select preset stations?

  Are you sure? yes | no

aqvarius-sey wrote 05/18/2017 at 14:57 point

on version 1.1.5 strange problem. if you have installed memory and increase the volume of the radio goes silent. only a reboot helps. if the memory is to retrieve all works. checked all the connection is correct.

  Are you sure? yes | no

aqvarius-sey wrote 05/18/2017 at 10:05 point

hi! in the beginning I want to say thank you for a great project! I have a question to the Creator. updated from version 1.1.5 to 1.2.1. buttons connected to an analog input. problems: 1. when adjusting the volume there is no smooth adjustment while holding the button. 2. when you press short the volume randomly changes (jumps from low to high and back). in version 1.1.5 often, she cleared the EEPROM in the esp8266, you need to re-set the network settings, and list of stations.

  Are you sure? yes | no

AndrzejSc wrote 05/16/2017 at 14:32 point

I have a problem when change uart to 9600, after reset radio doesn't play. If I change back to 115200 it's play again. Debug informations is the same at both cases. Any ideas ?

  Are you sure? yes | no

Similar Projects

Does this project spark your interest?

Become a member to follow this project and never miss any updates