Skip to content

🔩 Firmware Upgrade ​

Firmware ships inside the installer — nothing to download. Day-to-day upgrades are one click in Settings → Device.


How to upgrade ​

  1. Open Settings (the ⚙ at the bottom of the left shortcut library)
  2. Switch to the Device tab
  3. Look at the Firmware version row:
    • Already current → it just shows the version (e.g. 1.0.21)
    • A newer firmware ships with the installer → it shows current → available plus an Upgrade button
  4. Click Upgrade → a progress dialog walks through: enter download mode → wait for USB drive → write firmware → re-check version
  5. “Upgrade succeeded, device is running x.x.x” means done

While upgrading ​

NoteDetail
Don't unplug USBAn interrupted write can leave the device in download mode
Closing the dialog is safeThe upgrade keeps running in the background and the version is re-checked
Just retry on failureNo automatic retry — close the dialog and click Upgrade again
Status textOffline → “Device not connected”; in progress → “Upgrading…”

Manual download mode (troubleshooting) ​

If the automatic flow can't proceed, use Settings → Device → Enter upgrade mode (“enter download mode”): the device shows up as a USB drive labelled QUAKE DFU — copy the firmware from resources/firmware onto it. A brief black screen and reboot during the process is normal.

Prefer the Upgrade button for normal upgrades — it verifies versions for you.

Released under MIT License