OLED Animation Maker OLED Maker
📡 WiFi OLED · ESP8266/ESP32

Wireless WiFi OLED Arduino Guide, ESP8266 & ESP32 Live Preview (No USB)

The first time I saw an OLED animation update wirelessly, I actually laughed out loud. My ESP8266 was sitting on a shelf across my workshop, no cable connected to my laptop, and yet every change I made in the browser ...

By Ashish June 13, 2026 12 min read ESP8266 ESP32 SSD1306 WiFi
📖

A tutorial you can follow

I wrote this for makers. You get the wiring, the code and the mistakes I see most.

🔌

Hardware you already own

It suits SSD1306 and SH1106, and you'll find pin tables where they help.

💻

Code you can paste

Sketches you can upload in Arduino IDE as they are.

✨

A free tool for you

Want more animations? Preview and export them at oledanimationmaker.com.

Wireless WiFi OLED Arduino Guide, ESP8266 & ESP32 Live Preview (No USB): examples of pixel art and animations on a 128x64 SSD1306 OLED display
ESP8266 NodeMCU and ESP32 with 128x64 SSD1306 OLED wireless animation preview from oledanimationmaker.com browser over home WiFi
Wireless OLED display animation preview: pick any template in the browser, it plays on your physical SSD1306 over WiFi.

The first time I saw an OLED animation update wirelessly, I actually laughed out loud. My ESP8266 was sitting on a shelf across my workshop, no cable connected to my laptop, and yet every change I made in the browser appeared on that little screen instantly. It felt like I'd found a cheat code. If you've been tethered to a USB cable for all your OLED projects, you'll love this.

Here's what this guide covers. You'll learn how to preview SSD1306 OLED animations wirelessly on ESP8266 (NodeMCU, Wemos D1) and ESP32 boards over your home WiFi. It's the same live preview you'd get with WebSerial over USB, except it's completely cable-free after a one-time sketch upload. You edit in the browser, and your physical OLED updates over the network.

The best part? Your ESP joins your existing home WiFi. It doesn't create some separate hotspot that cuts off your internet. Your laptop and phone stay connected as usual, the website keeps working, and frames stream to your display in the background. I'll walk you through the wiring, the WiFi receiver sketch, finding your ESP's IP address, and connecting from the browser. Let's get your OLED untethered.

Why wireless OLED preview is worth setting up

Before we get into setup, let me explain why this matters and when you'll actually use it. Wireless preview isn't just a gimmick. It solves real problems you'll hit too, and here's how:

  • Test in the final location. If your project will live inside an enclosure, mounted on a wall, or built into something, you can see how the animation looks in place. You won't need a cable snaking back to your computer.
  • No cable clutter. When you're iterating on an animation for an hour, a USB cable tugging at your board gets annoying fast. Wireless frees up your workspace, and that's a relief.
  • Demo without a laptop tether. Want to show someone your project? They can hold the device and walk around while you're changing animations from across the room.
  • Multiple boards at once. Working on several displays? You can preview to whichever one you want over the network.

Honestly, wireless is my default for any ESP-based project now, and I don't miss the cable. You don't realise how nice it is to be free of the USB port until you've tried it.

ESP8266 NodeMCU wireless OLED setup

The ESP8266 (in NodeMCU or Wemos D1 form) is the most popular and budget-friendly board for this. It costs just a few dollars, has built-in WiFi, and packs enough RAM to hold a 128×64 frame buffer. To get started, wire your SSD1306 display to D2 (SDA) and D1 (SCL), upload the WiFi receiver sketch from the app, and you're streaming frames from oledanimationmaker.com over your router. You'll find the full step-by-step below.

ESP32 SSD1306 wireless OLED setup

Prefer the more powerful ESP32? The process is nearly identical, and you'll feel right at home. It isn't any harder. ESP32 uses GPIO 21 (SDA) and 22 (SCL) for I²C. Just select ESP32 DevKit in the tool, copy the WiFi receiver, add your router credentials, and connect using the IP that's shown on the display. The ESP32's extra memory and speed make it great if you're also running other tasks alongside the display. See my complete ESP32 OLED animation guide for more on that board.

WiFi vs USB, which should you use?

MethodBoardsCableInternet while editing
📡 WiFi ConnectESP8266, ESP32None after upload✅ Yes (home WiFi)
🔌 USB ConnectUno, Nano, ESP32, ESP8266...USB required✅ Yes

Important: The ESP connects to your existing router, not a separate "ESP-only" hotspot. That way oledanimationmaker.com keeps working, and you won't lose internet on your phone or laptop.

What you need

  • ESP8266 (NodeMCU / Wemos D1) or ESP32 DevKit
  • 128×64 SSD1306 OLED (0.96″ typical)
  • Your home WiFi network (router), with its SSID and password
  • The Arduino IDE with ESP board support, plus the Adafruit SSD1306 library
  • Google Chrome or Microsoft Edge on the same WiFi network
  • oledanimationmaker.com, free, no install

Step 1: Wire the OLED

Connect your I²C OLED to your ESP board (3.3V only):

  • ESP8266 (NodeMCU): SDA → D2, SCL → D1, VCC → 3.3V, GND → GND
  • ESP32: SDA → GPIO 21, SCL → GPIO 22, VCC → 3.3V, GND → GND
ESP32 board wired to 0.96 inch I2C OLED display with labeled SDA SCL power and ground connections
Use 3.3V. Most 0.96″ OLED modules aren't 5V tolerant.

Step 2: Configure the animation maker

  1. Open oledanimationmaker.com
  2. Set Board → ESP8266 (NodeMCU) or ESP32 DevKit
  3. Set Display → 0.96″ 128×64 SSD1306
  4. Set Library → Adafruit SSD1306
  5. Set I²C address → 0x3C (or 0x3D if needed)

The WiFi receiver sketch is generated to match these settings, so keep them the same in the app and on your board.

Step 3: Upload the WiFi receiver sketch

  1. Click 📡 WiFi in the app header
  2. Copy the WiFi receiver sketch
  3. Edit these two lines at the top of the sketch:
    const char* WIFI_SSID = "YourHomeWiFi";
    const char* WIFI_PASS = "your-wifi-password";
  4. Paste it into the Arduino IDE and select NodeMCU 1.0 or ESP32 Dev Module
  5. Upload once. You can unplug USB after this if you power the ESP another way

On boot, your OLED shows "Connecting WiFi", then your ESP's local IP address (e.g. 192.168.0.109). Write it down.

Step 4: Connect wirelessly in the browser

Browser showing OLED animation maker with template gallery and live hardware preview workflow
  1. Make sure your phone or PC is on the same home WiFi as your ESP
  2. Open oledanimationmaker.com (internet works normally)
  3. Click 📡 WiFi → enter the IP from the OLED (e.g. 192.168.0.109)
  4. Click Connect WiFi. You should see WiFi Ready
  5. Pick any template, import a GIF, or draw, and the animation appears on your physical OLED

If Chrome asks to allow access to devices on your local network, click Allow. The browser needs that to reach your ESP's local IP from an HTTPS website, so don't skip it. It's a one-click step.

How it works (under the hood)

The browser sends each OLED frame to http://YOUR_ESP_IP/frame using the same bitmap packet format as USB WebSerial (0xAA 0xBB + 1024 bytes for 128×64). The ESP decodes the frame and calls drawBitmap() on the SSD1306. When you change templates or play an animation, new frames stream automatically. You don't need a "Get the Code" upload while you're tuning.

Troubleshooting wireless preview

  • "Couldn't reach the ESP": you've got the wrong IP, the ESP is offline, or your phone's on a different WiFi band/network than the ESP
  • WiFi failed on OLED: double-check WIFI_SSID and WIFI_PASS in your sketch
  • POST /frame 400 error: re-copy the latest WiFi sketch from the app. The display size in the tool must match your sketch (128×64)
  • Blank OLED after connect: you've got the wrong I²C address (0x3C vs 0x3D), or an SSD1306 vs SH1106 mismatch
  • Arduino Uno: it has no built-in WiFi, so use 🔌 USB Connect instead
  • Compile error on ESP8266: use the latest sketch from the app, and install the Adafruit SSD1306 + GFX libraries

When to use WiFi vs Get the Code

  • WiFi / USB live preview: use it while you're editing, trying templates, and tuning FPS and pixels
  • Get the Code: use it when your Arduino OLED animation project is finished and has to run standalone, without a PC or browser nearby

Frequently asked questions

Do I lose internet when using wireless OLED preview?

No. The ESP joins your existing home WiFi router. It doesn't create a separate hotspot. Your phone or PC stays on the same network with full internet, and oledanimationmaker.com loads as usual.

Which boards support wireless WiFi OLED preview?

ESP8266 (NodeMCU, Wemos D1 Mini, WitPro) and ESP32 DevKit. Arduino Uno has no WiFi, so use USB WebSerial Connect instead.

Is wireless preview the same as USB Connect?

Yes. Templates, GIF import, drawing, and timeline playback all stream to your physical OLED the same way. USB uses WebSerial, while wireless sends frames over your local network.

Can Arduino Uno show wireless OLED animations?

Not with this feature, because an Uno needs an external WiFi shield. Use USB Connect on Uno, or upgrade to ESP8266 / ESP32 for wireless ssd1306 wifi arduino preview.

What display size and driver are supported?

128×64 SSD1306 with Adafruit SSD1306 library and I2C 0x3C or 0x3D. Match the display settings in the app to the sketch you've uploaded.

The ESP joined WiFi but the browser cannot reach the IP on the OLED

Your phone and ESP must be on the same LAN. Guest WiFi and "client isolation" on the router block device-to-device traffic even when both look connected. Use your main home network, allow local-network access if Chrome asks, and type the IP exactly as the OLED printed it.

The IP address changed after I unplugged the ESP

Home routers hand out DHCP addresses. After a power cycle your OLED may show a different address than the one you typed yesterday. Read the new IP from the display and enter that in the WiFi dialog. You don't need to re-flash unless the sketch itself failed to reconnect.

Why does the ESP stay on "Connecting WiFi"?

The sketch joins the router named in WIFI_SSID. A typo, a 5 GHz-only SSID, or the wrong password leaves it retrying. ESP8266 and most ESP32 boards use 2.4 GHz. Confirm your board is on 3.3 V and SDA/SCL are D2/D1 (ESP8266) or GPIO 21/22 (ESP32). Then re-check the two credential lines and upload once.

Try wireless WiFi preview, free

Upload the WiFi receiver once, click 📡 WiFi Connect, and you can show any animation on your OLED without a USB cable.

Open OLED Animation Maker →

Worked example: from upload to the first wireless frame

Use the WiFi receiver the site generates, and only edit the two credential lines. That's all you need to touch. Put your real home network name and password in place of the placeholders that are already in that sketch:

const char* WIFI_SSID = "YourHomeWiFi";
const char* WIFI_PASS = "your-wifi-password";

Those strings must match the router your laptop's already using. The ESP doesn't invent a new network, and it doesn't become a hotspot. It joins the same LAN, so your browser can still load the site and then send frames to the board. That's why you keep your internet.

Wire it up before that upload. On an ESP8266 NodeMCU, SDA goes to D2 and SCL to D1, both at 3.3 V. On an ESP32, SDA goes to GPIO 21 and SCL to GPIO 22, also at 3.3 V. In the tool, set the display to 128×64 SSD1306 and the I²C address to 0x3C, unless your module is 0x3D. Select NodeMCU 1.0 or ESP32 Dev Module in the IDE, upload once, and leave the OLED attached.

On boot the glass should say it's connecting, then print a local address such as the 192.168.0.109 example from earlier on this page. Your router may assign a different number, so write down whatever your OLED actually shows. Don't assume it's the same. On your computer, stay on that same home WiFi, open the site in Chrome or Edge, click the WiFi control, paste that IP, and connect. If the browser asks to reach devices on the local network, allow it. You'll see the prompt only once. Play any short template. The panel should follow the canvas, and you won't need another upload.

Each 128×64 frame is 1024 bytes. As I said above, the browser posts that bitmap to http://YOUR_ESP_IP/frame with the same 0xAA 0xBB header used by the USB path. You don't type those bytes yourself. If the tool and the sketch disagree on 128×64, the board answers with a 400 and the glass stays on the IP screen. If you change the display size, re-copy the receiver and upload it again.

When the animation looks right, you'll want Get the Code for a sketch that plays with no browser and no router session. The WiFi receiver is only for design time, so don't ship it.

Troubleshooting a board that joined the wrong place

  • OLED never leaves "Connecting WiFi". Your SSID or password doesn't match the router. Re-enter them, watch for a trailing space, and confirm that the network's 2.4 GHz. An ESP8266 can't use a 5 GHz-only name.
  • IP shows, browser times out. Your laptop's on guest WiFi, a VPN, or a second router. Client isolation hides the ESP from other devices. Connect your computer to the same LAN the OLED joined, then try the IP again. It'll work once you're on the same network.
  • Yesterday's IP fails today. DHCP changed it. Read the address on the glass after reset. If the OLED is stuck on an old address after you've fixed the password, press the EN or RST button.
  • Connect succeeds, picture is blank or shifted. Check the address, 0x3C versus 0x3D, or whether you've got an SH1106 module running an SSD1306 receiver. Match the tool, re-copy the sketch, and upload once. That's usually the whole fix.
  • Frames stutter, then stop. Your WiFi's weak at the shelf, or the USB cable was the only power and you unplugged it without another 3.3 V/5 V supply for the board. A brownout reboots the ESP, so wait for a new IP and connect again. It isn't a bug in the sketch.
  • Uno is in the parts bin. It has no radio, so use USB Connect for it. Wireless preview in this article is for ESP8266 and ESP32.

Related tutorials

Free tools: OLED Animation Maker for your SSD1306 and SH1106 animations, Assemble Studio for your name and logo animations, the Shadow Box Lamp Generator for your 3D-printed shadow lamps, Text to STL for your 3D-printed names and keychains, and 3MF to Web to show your 3D prints on any website. New: the Image to Byte Array converter, the OLED Robot Eyes generator and the Lithophane Maker. See all tools.