No additional software is required. Use Chrome or Edge on a desktop computer. Connect the board by USB before starting. New to the device? Read the Husbandry Guide first, or the Build Guide if you're assembling one from parts.
There are two versions of the pet. Flash the one that matches your board; they meet and fight each other over Bluetooth just the same.
WURMagotchi CYD (handheld)
Cheap Yellow Display (ESP32-2432S028R), 2.8" 320×240 resistive touch screen. The original handheld; saves to a microSD card.
Your browser doesn't support Web Serial, open this page in Chrome or Edge on a desktop.This page needs to be served over HTTPS (or from localhost) for the browser to allow serial access.
Click the button, select the board's serial port, then select Install. The process normally takes less than one minute.
WURMagotchi Touch (watch)
Waveshare ESP32-S3-Touch-AMOLED-1.64, a 1.64" 280×456 AMOLED touch board. Portrait, swipe-driven, sized for a watch or keychain case; saves to its own flash, no SD card needed.
Your browser doesn't support Web Serial, open this page in Chrome or Edge on a desktop.This page needs to be served over HTTPS (or from localhost) for the browser to allow serial access.
Same process. If the port doesn't appear, hold the board's BOOT button while plugging in USB, then try again.
Your saved würm is safe. This writes the bootloader, partition table, and application, everything a blank board needs to boot. The CYD keeps your pet, settings, and achievements on the microSD card, and the Touch build in a separate flash region this never touches.
Wi-Fi is set up on the device. Both versions can set their clock over Wi-Fi: open Settings and pick the Wi-Fi setup option, join the "WURMagotchi-XXXX" hotspot from your phone, and choose your network. No password is built into these downloads.
Wurm Beacon (optional)
Seeed XIAO ESP32-S3 (or any ESP32-S3 board). A broadcast-only beacon with no screen, meant to be left running on a table so any questing WURMagotchi nearby has something to find. See Encounters in the Husbandry Guide.
Your browser doesn't support Web Serial, open this page in Chrome or Edge on a desktop.This page needs to be served over HTTPS (or from localhost) for the browser to allow serial access.
Same process: select the board's serial port, then Install.
If it fails partway, unplug/replug the board and try again, a half-written flash is safe to retry. If the port never shows up, close any other program that might be holding it open (Arduino IDE's Serial Monitor, PlatformIO, etc).