ESP32 FIRMWARE UPDATER

Clicker Device Installer

Update and flash your Clicker hardware directly from your browser over USB using Web Serial.

100% NVS Data Preserved

Firmware updates target application offset 0x10000 with chip-erase strictly disabled. Your lifetime clicks, unlock milestones, and stats stored in NVS (0x9000) remain untouched.

Web Serial Flash

USB DIRECT
Version
v1.0.0
Flash Offset
0x10000
Binary Size
~360 KB
Interactive Installation Options
Option A • Update (Keep Data): Leave "Erase device" unchecked in the popup to preserve all lifetime clicks, milestones, and statistics.
Option B • Clean Install (Erase): Check "Erase device" in the popup to factory reset the hardware and format all NVS storage.
Web Serial is not supported on this browser. Please open this page in Chrome, Edge, or Brave, or see the manual options below.
Web Serial requires a secure context (HTTPS) or localhost.

Firefox, Safari & Manual Options

If your browser does not support the Web Serial API (e.g. Safari, Firefox, iOS), choose one of the reliable alternatives below:

⚠️ DATA LOSS WARNING: Third-Party Web Flashers

Third-party web tools like web.esphome.io perform an automatic full-chip erase that COMPLETELY WIPES ALL SAVED DATA (click counts, cycles, milestones, and settings in NVS memory).

👉 To update your device without losing your saved stats, use the Official Web Installer above (in Chrome/Edge) or run .\flash_device.bat from our repository.

Option 1: Switch Browser (Safe)

For one-click web updates with full data preservation, open this page in Google Chrome, Microsoft Edge, Brave, or Opera.

Recommended • Keeps All Click Stats

Option 2: web.esphome.io (Wipes Data)

Notice: web.esphome.io will erase all user stats. Use only for full factory reset or recovery:

  1. Download factory_firmware.bin below (Offset: 0x0).
  2. Go to web.esphome.io.
  3. Click Install → Select factory_firmware.bin.
Open web.esphome.io (Full Erase) →

Option 3: esptool.py (Desktop CLI)

Flash the merged factory image directly to offset 0x0:

esptool.py --chip esp32 --port COMx write_flash 0x0 factory_firmware.bin
Or run flash_device.bat in the repository for interactive data preservation.

Understanding Manual Binary Files & Data Safety

  • factory_firmware.bin (Flash Offset: 0x0) • Complete merged image containing bootloader, partitions, and firmware. Required for third-party flashers (web.esphome.io) or recovering a non-booting board.
  • firmware.bin (Flash Offset: 0x10000) • Application-only update. Flashing to 0x10000 without running erase_flash guarantees your lifetime clicks and milestone stats in NVS (0x9000) remain 100% intact.
  • Recommended Desktop CLI Tool: Run .\flash_device.bat in the repository to interactively choose between keeping your data or doing a clean factory reset.

Direct Factory Firmware Downloads (Offset 0x0)

Download Factory Binary (factory_firmware.bin) for manual flashing via web.esphome.io or esptool (Flash Offset: 0x0).

Release Version Flash Target Binary Size Action