Install the firmware on your board, straight from the browser.
You need exactly this board: Waveshare ESP32-S3-Touch-LCD-1.28-B – the version with the metal case. Check the exact name: it must say ESP32-S3 and Touch. Not the RP2040 version, not the version without touch – they look almost the same but won't work. Shops often call it “ESP32-S3 Development Board with 1.28inch Round Touch LCD, Accelerometer Gyroscope Sensor” – the built-in motion sensor is what lets the eye feel knocks, shakes and tilts (and play Moonball).
Buy it e.g. at Eckstein (Germany, exactly this version with metal case), from the official Waveshare shop or a trusted electronics store – avoid marketplace listings, they are often mislabelled.
- Use Chrome or Edge on a computer (Windows, Mac or Linux). Firefox only works in a roundabout way (it asks to install a permission add-on), phones and Safari can't install at all. No Chrome? It's free at google.com/chrome.
- Connect the board to this computer with a USB-C data cable. (Some cables only charge – if no port shows up in step 5, try another cable.)
- Switch the board on. The board starts as soon as it gets power.
Whatever the board shows right now (a maker demo, text, colours) doesn't matter – it gets replaced. During the install the screen may freeze or go dark – that's normal. - Click “Install” below.
- A window lists the ports. Pick the board – usually called “USB-Enhanced-SERIAL CH343 (COM…)” (Waveshare), “USB JTAG/serial debug unit”, “USB Serial Device (COM…)” or on a Mac (Apple computer) “…usbmodem…” – and click “Connect”.
Several entries and not sure? Unplug the board for a moment: the entry that disappears is the board. Plug it back in, switch it on and click “Install” again. - In the next window click “Install”, tick “Erase device” for a clean start and confirm. Now wait 1–2 minutes – don't unplug the board – until it says “Installation complete”. You can then close the window. The eye starts by itself (if the screen stays dark, switch the board on again). Without the tick, saved Wi-Fi and settings are kept – handy if you reinstall later.
From now on the board doesn't need the computer any more: you can unplug it, connect it to a normal USB power adapter (e.g. a phone charger) at its new place and continue there (switch it on again if needed, see step 3). - The screen now shows a QR code (tap it and you briefly see the eye, still grey and without prices) – that's normal: it doesn't know your Wi-Fi yet. So now, Wi-Fi: scan the QR code with your phone camera – that connects your phone to the eye's own Wi-Fi “Moonwatcher-Setup” (no password; without the QR code, pick it in your phone's Wi-Fi settings). A page opens by itself (if not, open 192.168.4.1 in the phone's browser). Tap “Configure WiFi”, pick your home Wi-Fi, enter its password, tap “Save”.
Good to know: only 2.4 GHz Wi-Fi works (if your network is missing, use the one without “5G” in its name). If your phone asks “No internet – stay connected?”, say yes. After saving, “Moonwatcher-Setup” disappears and your phone returns to your Wi-Fi – that's normal. If “Moonwatcher-Setup” shows up again after 2 minutes, the password was wrong: just repeat this step. Says “Wrong password?” although it's right? Then your router is blocking new devices – e.g. on a FritzBox switch on “Allow all new Wi-Fi devices” (Wi-Fi → Security) and try again. - After about a minute the eye opens and turns colourful (green, orange or red). Grey means it's still loading. Done! 🎉
To open the settings page later (pick your coin, brightness, clock …): your phone must be back in your home Wi-Fi – the one you just gave the eye (not “Moonwatcher-Setup”, not mobile data). On the eye, swipe up (keep swiping up) until it says “Settings”, then hold your finger on it. A QR code appears – scan it with your phone camera and tap the link that pops up (“Open”, “Open in browser”); the settings page opens on your phone.
A fresh install erases the board, including saved Wi-Fi and settings. Updates later arrive over Wi-Fi by themselves.
What the eye shows and how to use it: the manual.
Your eye is running? 🎉 Moonwatcher is free – if it brings you joy, I'd be happy about a small tip.
← Back to the Moonwatcher page · © 2026 Torsten Hillmann
Ideas & design: Torsten Hillmann (@manhill) · Funktronix. Built with Claude, an AI by Anthropic.
Testing & prototype case: Bix