Firmware
Installing the firmware
The Cheevotron app installs Cheevotron's firmware on consoles that need it, starting with the ModRetro Chromatic. This page covers the Chromatic; the Game Bub guide and the AVS guide cover theirs. You don't need a computer: the phone does it over a USB-C cable. See also the firmware page. No Android phone? An iPhone can't reach the console's USB chips, so install it from a computer with Chrome or Edge; after that, the iPhone app pairs the Chromatic over Bluetooth.
At your own risk. We test every release carefully on our own consoles, but installing community firmware is at your own risk, and we can't be responsible for damaged or unusable devices. On the Chromatic, the app always backs up your original firmware first. The Game Bub gets no backup: a restore writes the original firmware the app carries.
Before you start
- Charge the Chromatic or use fresh batteries, and keep it switched on during the whole process.
- Use a USB-C data cable between the phone and the Chromatic (some charging-only cables don't carry data).
- Connect only one Chromatic.
- Plan about three minutes the first time (the backup comes first), about one minute for an update.
Installing
- Connect the Chromatic to the phone and switch it on.
- In the app, open Settings › Chromatic. Under Firmware it shows what's on your Chromatic.
- Choose Install Cheevotron (or Update to Cheevotron, when a newer version is ready; the button names the version) and confirm. Android may ask once or twice to allow access to the Chromatic. The app:
- backs up both firmware chips the first time and checks every part of the copy against the console;
- writes the new FPGA design and reads it back to compare it;
- writes the new ESP32 firmware and verifies it;
- checks that the console answers again.
- When it says it's done, the Chromatic runs Cheevotron. Unplug the cable and pair it over Bluetooth.
Keep the screen open while it runs. The game stops during the install.
The backups go to your phone's Downloads › Cheevotron › Chromatic backups folder. Copy that folder somewhere safe, for example to a computer or your cloud storage.
Going back to the original firmware
Choose Restore a backup…. The app writes your own backup back, in the safe order, and verifies it. If you made a backup of ModRetro's firmware on a computer before, use Import backups… first to add it.
ModRetro's own update tool is another way back to their latest firmware.
If something goes wrong
- Don't unplug during a write. The app never stops a write halfway on its own.
- A write was interrupted (loose cable, empty battery): the Chromatic's programming chip still answers even if the console doesn't start. Connect it and run the same action again; the app can finish the job through that chip.
- The app doesn't find the Chromatic: check that it's switched on, try another cable, and allow access when Android asks.
Settings › Diagnostics keeps a log you can share if you need help.
Last updated November 20, 2026. Something unclear or wrong? Tell us at hello (at) cheevotron (dot) com and we'll fix the page.