Flash ChronoBloom

Puts the clock firmware on a Seeed XIAO ESP32-C3, from this page. No compiler, no toolchain, nothing to install.

This browser cannot flash. Flashing uses Web Serial, which today only Chrome, Edge and Opera implement, on desktop. Safari and Firefox do not, and neither does any browser on iOS. Open this page in Chrome or Edge on a computer.

The flash tool failed to load. Check your connection or ad blocker and reload the page.

This page has to be served over HTTPS to flash.

This binary is the 8-inch build. The 15-inch variant currently needs building from source with PlatformIO.

Plug the board into a USB-C port first, then press the button and pick the serial port that appears. Flashing takes about a minute.

Before you start

A Seeed XIAO ESP32-C3. This binary is built for that exact board and no other.
A USB-C cable that carries data. Charge-only cables are the single most common reason no port shows up.
Chrome or Edge, on a desktop.

What happens after it flashes

Right after flashing, the browser may offer to set up WiFi itself, no phone needed. If that box shows up, type in your network name and password there and skip ahead to the last step. Do it promptly: the clock only listens to the browser for a short while, and while it is listening the rings hold teal.
If that box never shows up, or you close it, or it sits there and then says it timed out, nothing is broken. The rings turn blue and the clock opens a setup network of its own. That route always works, so use it and carry on below.
On your phone, join the WiFi network esp32c3-clock-setup. It has no password.
A setup page opens by itself. If it does not, go to http://192.168.4.1.
Pick your network and enter its password. The clock saves it and connects.
Open http://esp32c3-v3-8inch.local/ to reach the clock, then set your time zone under Time & light. It gets the time itself from the internet after that.
If that address does not load, find the clock in your router's device list and browse to its IP address directly.

If the browser never offered WiFi setup and the rings never turn blue either, the flash did not take. Re-seat the cable and run it again.

Updating later

Come back to this page and flash again, or upload the plain firmware.bin from a release to http://esp32c3-v3-8inch.local/update over your own network. Your settings survive both.

If it does not work

No port in the list	Charge-only USB cable, or the board is not plugged in. Try another cable first.
Port is there, flashing fails	Close anything else holding the port: a serial monitor, Arduino IDE, PlatformIO.
Flash failed or got interrupted	No harm done. A failed flash cannot brick the board. Run the flasher again and pick the erase option.
Button does nothing	Not Chrome or Edge, or the page is not on HTTPS.
Browser WiFi box timed out	The clock only listens to the browser for a short while after it boots, so a slow answer misses it. The flash itself was fine. Wait for the blue rings and set WiFi up on the clock's own network instead.
Flashed, but no lights	Check the wiring from the board's 5V pin to the rings. One USB-C charger powers everything, there is no separate LED supply.
Lights, but wrong positions	Wiring or LED order. See HARDWARE.md.

Building from source instead

You do not need to, but everything is there: github.com/Maestro8484/ChronoBloom. PlatformIO, pio run -e esp32c3_v3_8inch. That path is for changing the firmware, not for using the clock.