Updating Firmware
Firmware updates add games and fix link bugs. Install the launcher’s version from the browser, install your own .uf2, or copy a file onto the board by hand.
Web update (recommended)
The easiest way to update is through the launcher:
- Go to launcher.gblink.io in Chrome or Edge.
- Click Connect and select the adapter.
- Read the Firmware line in Device Health.
- If the panel says Update available, click Update firmware and wait until it finishes.
- If the page asks you to reconnect, click Connect again and check that Firmware shows the new version.
You do not download a file. The launcher writes the firmware in the browser. Firefox can show the version, but it cannot do this one-click write. Use the manual steps below.
Custom UF2
Use this when you have your own .uf2, such as a build from
Building from Source, instead of a version the launcher already lists.
- Open launcher.gblink.io in Chrome or Edge and click Connect.
- In Device Health, open Version to install.
- Choose Select custom firmware (uf2). A file picker opens.
- Pick your
.uf2. The heading changes to Install custom firmware: and shows the file name. The button changes to Install custom firmware. - Click Install custom firmware and wait until it finishes.
- If the page asks you to reconnect, click Connect again and check Firmware.
Canceling the file picker returns the panel to the bundled version. If the page cannot read the file, pick another .uf2.
Firefox can select the file the same way, but it cannot write it in one click. After the file is chosen, open Flash manually instead, download it, and follow the manual steps below.
Manual update
Use this if you are on Firefox, or if the one-click update stops.
- Download
gblink.uf2from the latest release on GitHub, or use Download firmware (.uf2) on the launcher. - Unplug the adapter.
- Hold the BOOTSEL button on the board.
- While holding BOOTSEL, plug the adapter into USB.
- Release BOOTSEL. A drive named RPI-RP2 appears.
- Copy the
.uf2file onto that drive. - The drive disappears and the adapter reboots on the new firmware.

After updating
- Click Connect again.
- Check that Firmware in Device Health matches the version you just installed.
- If a game still fails, unplug the adapter, plug it back in, and connect again.
Troubleshooting
| Issue | Fix |
|---|---|
| Update stalls | Unplug, hold BOOTSEL, reconnect, and try manual flash |
| Wrong version shown | Refresh the page; reset the adapter |
| Device not recognized after flash | Try a different USB port or cable |
For technical build instructions, see Building from Source.