jgordon510/esp32_cyd_wordle — explained in plain English
Analysis updated 2026-05-18
Build a standalone hardware Wordle game showing the actual daily NYT word.
Learn how to drive an ILI9341 touchscreen with MicroPython on ESP32.
Repurpose a Cheap Yellow Display board into a small offline game device.
| jgordon510/esp32_cyd_wordle | 0-bingwu-0/live-interpreter | 0cm-labs/tokenizer-benchmark | |
|---|---|---|---|
| Stars | 2 | 2 | 2 |
| Language | Python | Python | Python |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 2/5 | 2/5 | 2/5 |
| Audience | developer | general | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires an ESP32 Cheap Yellow Display board, MicroPython flashing tools, and a 2.4GHz Wi-Fi network.
CYD Wordle is a MicroPython project that turns the ESP32 based Cheap Yellow Display board into a small standalone Wordle machine. On boot, the device connects to your Wi-Fi network, checks the date for your configured time zone, downloads that day's real New York Times Wordle answer, then disconnects from Wi-Fi to free up memory before starting the game. From that point on, everything runs offline on the device itself. The game plays like the familiar word puzzle: you get six guesses to find a five letter word, with letters colored green, yellow, or gray as hints, and an on screen keyboard that recolors as you play and never downgrades a key from green. You tap letters on the touchscreen to spell a guess, tap any square in the current row to move the cursor there, and submit with a dedicated key that turns green once you have typed a real word from the built in dictionary. To use it, you flash MicroPython onto the ESP32 CYD board, set your Wi-Fi name, password, and time zone in a small configuration file, then copy the project files onto the board with the mpremote tool. The code is organized into a handful of files: the main program handling boot, networking, drawing, and game logic, a color palette helper, a touch screen driver, and the word list itself, which is stored as a fixed size, sorted file on the board's flash storage and searched directly rather than loaded into memory, since the ESP32 does not have much RAM to spare. The project notes that memory is the tightest constraint on this hardware: the secure connection needed to fetch the daily word requires a large block of free memory, so the code cleans up and drops the Wi-Fi connection before starting the game loop. It fetches the current date from a free public time API and the daily puzzle from a public New York Times endpoint, neither of which requires an API key. It is released under the MIT license, and touch calibration may need adjusting since touchscreen panels vary from unit to unit.
Turns an ESP32 Cheap Yellow Display board into a standalone Wordle game that downloads the real daily NYT word.
Mainly Python. The stack also includes MicroPython, ESP32, ILI9341.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.