eenkstudio.
PREVIEW

Design your display.

Start with an idea. Make every pixel your own.

Private & local
▤Not saved
EDITOR PREVIEWSample live values
200 × 200 px1.54″ E-PAPER · BLACK / WHITE
Select an element. Arrow keys nudge 1 px; Shift + arrow nudges 10 px.

Preview Wi-Fi changes only simulated layout values. It never sends a radio action, changes Wi-Fi, or reports this computer’s network.

▣
Waveshare ESP32-S3 · V2USB disconnected · 90° clockwise output
Waveshare ESP32-S3 1.54-inch e-paper development board product reference

DON'T HAVE A BOARD YET?

Need a board?

Find the Waveshare ESP32-S3 1.54inch E-Paper AIoT Development Board on Amazon. You can keep exploring templates and designing here before you connect a device.

Choose V2. Confirm the seller supplies the V2 revision before buying. This editor does not currently support V1 or colour models.

View board on Amazon

Affiliate link. As an Amazon Associate I earn from qualifying purchases.

TAKE YOUR DESIGN WITH YOU

Export your design.

ZIPs are created locally; extract and import any layout.json to edit it. C++ headers target the Waveshare V2 driver. Weather feeds and additional sensor readings marked DEMO are editable examples, not connected services.

REUSABLE BY DESIGN

Save in your library.

Saved only in this browser. Export JSON to back it up or share it with someone.

YOUR DEVICE. YOUR PERMISSION.

Connect your display.

▣
Waveshare ESP32-S3 e-Paper V2

1.54″ · 200 × 200 · black / white

SUPPORTED PROFILE

Plug your board into this computer with a data USB cable. Select only your own device when the browser asks. Wi-Fi can stay off.

Not connected. Editing and exporting still work.

Display refresh

Connect your own USB board to read or save display refresh settings.

Connect your board to read its saved refresh interval and sound choice.

Saved on this board for every layout and template. Defaults are one hour and sound OFF. Selection changes apply only when you click Save; they do not send your design or turn Wi-Fi on.

Automatic timing starts from the last completed screen refresh. A shorter interval may already be due. Send, BOOT refresh and Wi-Fi state changes can still request an earlier refresh. The sound plays after an actual screen update, not during reads or editor changes.

Weather polling is a separate setting below. The refresh-interval live field displays the saved screen interval, not weather polling or a countdown.

BOOT button action

Hold BOOT for about one second during normal operation. Short presses and PWR stay unchanged.

Connect your device to read its saved button action.

Saved on this board, independently of your design. Changing this setting does not perform the selected action or change Wi-Fi.

OpenWeather

YOUR API KEY

Connect your own USB board to save weather settings.

Stored only on your selected board, never in layouts, exports or browser storage. Leave empty to retain a saved key. Full-flash backups contain the key—keep them private.

No API key saved on this board yet.

Weather needs Wi-Fi ON. If BOOT is assigned Wi-Fi toggle, hold it about one second; the controls above can assign that action. Saving weather does not turn Wi-Fi on. Automatic fetching updates the cache; the screen uses your saved display refresh interval. Fetch now redraws only a weather-bound page.

Add outdoor fields under Element properties → Use a live value → OpenWeather, or choose the OpenWeather current template. Its live icon and outdoor-humidity bars/dials update from weather, not the room sensor. Samples in an unconnected preview are labelled DEMO.

New users: install ES1 first unless you want to test ES2 R2 - Beta. ES1 and ES2 are eenkstudio firmware versions, not board revisions. Both options are only for the Waveshare ESP32-S3 1.54″ E-Paper AIoT Development Board V2; neither supports the V1 board. If ES1 is already working, you do not need to reinstall it.

ES1 - Tested - OK

ORIGINAL FIRMWARE · RECOMMENDED FIRST INSTALL

The layout engine is installed once. After that, design edits are sent as data, not recompiled code. Installation replaces the app on the board, so back up your existing firmware first.

Download ES1 app image

Only the app region at 0x10000 is written. Saved Wi-Fi settings and the existing bootloader/partition table are retained. Do not use this image on other boards.

ES2 R2 - Beta

BETA FIRMWARE · NOT A PHYSICALLY QUALIFIED RELEASE

ES2 R2 — CONTROLLED PHYSICAL TEST ONLY. The first test build (d3ac1ea0) remains withdrawn: do not reinstall it. R2 restores the confirmed corrupted vendor waveform and prevents automatic low-battery cutoff before the first completed screen. This does not prove your blank panel will recover.

This software-verified build adds the live Wi-Fi icon, separate hour, minute, day and month fields, and completion-checked OFF shutdown. It has not completed full physical hardware qualification. ES1 - Tested - OK above remains the recommended original release.

Only for the Waveshare ESP32-S3 1.54″ E-Paper AIoT Development Board V2. Check your unit's V2 marking: identifying an ESP32-S3 chip alone cannot prove the board revision. Keep USB power connected throughout. No new screens or designs are sent by installing.

Preparation checks compatibility and reads backups. It does not write firmware.

Beta writes are app-only at 0x10000, with no whole-device erase. The necessary app sectors are erased; bootloader, partition table and data outside those sectors are checked unchanged before restart. Unsupported security or partition layouts stop installation. Never use this app image at address zero.

ES2 R2 app: 028a9ac3… · 1,847,136 bytes. If writing or verification fails, keep power connected and your backups safe; do not erase or retry blindly.

Download ES2 R2 - Beta app image only
FROM IDEA TO E-PAPER

Small screen. Simple workflow.

  1. Start with a template

    Or choose a blank canvas and add text, shapes, a pen stroke or an image.

  2. Make it yours

    Drag elements or edit precise coordinates. Bind text to a live clock or sensor value if you want it to change on the board.

  3. Keep a copy

    Save locally and export editable JSON. The C++ export includes the actual design data and rendering helper.

  4. Send to your device

    Use a supported desktop browser, install the matching engine once, then connect and send. Applying a design requests an immediate redraw; automatic redraw uses your saved display refresh interval.

Shortcuts: V select · T text · R rectangle · O ellipse · L line · P pen · Delete remove · Ctrl/Cmd+Z undo · Ctrl/Cmd+S save.