Install the firmware.
The same four steps as the Firmware tab in the desktop app, right in the browser. The firmware is built in advance for every supported display; pictures and the touch calibration on the deck stay where they are.
This browser cannot reach USB devices. Open the page in Chrome, Edge or Opera on a computer, or use the Firmware tab in the desktop app.
-
01
Pick your board
The little computer inside the Wdeck: a bare ESP32 you wire a display to, or a board with the display already on it.
Wiring- MOSI23
- MISO19
- SCLK18
- CS15
- DC2
- RST4
- T_CS21
- BL32
Wired as in the build guide.
-
02
Pick your display
Printed on the display board or in the shop listing. The Wdeck uses the ILI9488.
Colours come out inverted? Flash again with the other panel type.
Build it in the app
This board uses other pins, so the desktop app builds its firmware: open Install firmware in the app's left bar and go through the same steps.
- 03
-
04
Install
Wdeck firmware for ILI9488 · TFT.
Coming from a firmware older than October 2026? This version gives the pictures more room, so the first install clears the pictures and the touch calibration once. The app sends every picture again by itself, and the deck asks you to tap through the touch setup when it starts.
Before you flash.
Will it delete my key pictures?
Normally no. Only the program is replaced; pictures and calibration live in a separate part of the flash. They are only removed when you tick “Erase everything first”.
One exception: the firmware from October 2026 on gives the pictures more room, so the first update from an older firmware clears them and the calibration once. The deck asks you to calibrate again, and the app sends the pictures again when it connects.
Firefox, Safari or a phone?
They have no Web Serial, so they cannot reach the USB port. Use Chrome, Edge or Opera on Windows, macOS, Linux or ChromeOS, or the flasher in the desktop app.
Which board does this firmware run on?
The classic ESP32 (WROOM-32 / DevKit V1) wired as in the build guide. For an ESP32-S3 or a board with the display on it (the yellow ESP32-2432S028 and its siblings) use the desktop app, which builds the firmware for that board.
It stops at “Connecting…”
Hold the BOOT button on the ESP32 while you press Install, and let go when the progress starts. Close the Wdeck app first, because only one program can use the port at a time.