CPR-vCodex Tools

Browser-based installer

Flash CPR-vCodex

Install the latest CPR-vCodex firmware on your Xteink X4, X3 or X4 Pro from Chrome or Edge using Web Serial. It writes the inactive app partition and then switches boot to it.

Before you flash

Back up first

Skip this step if you have flashed before. If this is your first time, keep a "Save Full Flash" backup from https://xteink.dve.al/.

Use a data USB-C cable

Connect the Xteink to your computer. If no serial port appears, wake and unlock the device, then reconnect it. On the X4 Pro, unplug and replug the cable and hold Power if the port does not show up.

Use Chrome or Edge on desktop

Firefox and Safari do not support Web Serial. The browser will ask you to choose the Xteink USB serial port (ESP32-C3 on the X4 and X3, ESP32-S3 on the X4 Pro).

Do not unplug while flashing

The page validates the partition table, writes the inactive OTA app slot, updates otadata, and resets the device when it finishes.

Manual PlatformIO flash

For development builds, clone the repo, set the upload port, then use PlatformIO.

git clone https://github.com/boydj/cpr-vcodex.git
cd cpr-vcodex

# Xteink X4 / X3 (ESP32-C3)
pio run -e gh_release -t upload

# Xteink X4 Pro (ESP32-S3)
pio run -e x4pro-gh_release -t upload