Quick Start
Congratulations, you’re ready to set up your GB-Link adapter! This guide covers adapters from Etsy (v1), Crowd Supply (v2), or a DIY build.

1. Plug in your hardware
Firmware only: Skip the Game Boy and cartridge. Plug the adapter into USB, wait for the red light, then go to step 2.
To play a game: Set up your Game Boy first, then the adapter.

- Put your game cartridge in the console and turn it on. Leave it on for the rest of setup.
- Plug in the link cable:
- Game Boy or Game Boy Color: either end of a Game Boy Color cable works. Plug one end into the console’s link port and the other into the GB-Link adapter. An original Game Boy link cable does not work with V2.
- Game Boy Advance: the two ends are different. Plug the master (slim) end into the GB-Link adapter and the slave (wide) end into the Game Boy Advance. Swapping these stops GBA modes from working.

- Plug the adapter into your computer or Android phone with USB. Official GB-Link adapters use USB-C. Some DIY builds use Micro-USB instead. A charge-only cable will not work. Use one that carries data.
The adapter’s light should turn red ( LED guide) once it has power. That is your cue to move on to step 2. If it stays off, try a different USB cable or port.
V2 comes with a link cable. V1 and DIY boards do not, so bring your own. Avoid the cheapest GBA cables. Many of them have four wires and a bad ground, and the link drops.
2. Connect and check firmware
Open the Game/Tool Launcher in Chrome, Edge, or Firefox 151 or newer.
Find the Device Health panel. On desktop it sits on the right. On mobile it is below the game list.

Connect
- Click Connect.
- Approve the browser prompt for your adapter (table below).
- Wait until Status shows
Connectedand the LED turns green.
| Browser | What to select |
|---|---|
| Chrome / Edge | Game Boy Link in the USB picker, then Connect |
| Firefox 151+ | Continue to Installation, then Add, then GBLink USB, then Allow. Screenshots |
| Chrome on Android | Allow USB access if Android asks, then use the same USB picker as desktop |
Want every browser prompt spelled out? See Setting Up Your Adapter.
Check firmware
Look at the firmware line in the same panel:
| What you see | What to do |
|---|---|
Firmware shows a version (for example 2.2.1) and no update warning | You are up to date. |
| Update available: with an Update firmware button | Click Update firmware and wait for the flash to finish. Reconnect if it asks you to, then check that the new version shows under Firmware. |
The launcher already has the latest firmware file. On Chrome or Edge you do not download anything. The page writes it to the adapter.
Firefox users: The launcher can show your version over WebSerial, but one-click flashing needs Chrome or Edge. Use Flash manually instead on the launcher, or follow Updating Firmware.
3. Launch a game or tool
In the Game/Tool Launcher, with the adapter connected, choose a game or tool from the list. Common choices include Tetris, Dr. Mario, Pokémon Trading, Pokémon Gen 3, and Advance Wars. There are utilities too, like Game Boy Printer, GB Cart Doctor, and e-Reader. The RetroArch netplay app is listed under Desktop Clients.

- Click the game or tool you want.
- In that client, click Connect and pick the adapter again if it asks.
- Open the link screen in the game when the page tells you to. The steps for each game are on its page in Games & Tools.
If something fails to start or connect, go back to step 2 and update firmware if an update is available, then try again.
Cartridge requirements and per-game notes live in Games & Tools.
Troubleshooting
| Problem | Try this |
|---|---|
| Connect does nothing | Use Chrome, Edge, or Firefox 151+. See What you need. Unplug the adapter from your computer or phone, plug it back in, then click Connect again. |
| Browser can’t find the adapter | Unplug the adapter from your computer or phone, wait a moment, then plug it back in. Try another USB port or cable if it still does not show up. |
Firmware version shows Unknown | Unplug the adapter, plug it back in, then click Connect again. Refresh the page and reconnect if needed. |
| Update stalls | Unplug the adapter from your computer or phone, plug it back in, and try again. Or flash manually. |
| Page refresh broke the link | Unplug the adapter from your computer or phone (or press reset), plug it back in, then reconnect in Device Health. |
| Linux permission denied | Run ./scripts/setup-permissions.sh from the
firmware repo. |
If none of that works, ask in the GB-Link Discord. Include your browser, the firmware version from Device Health, and which game you were opening.
After your first connection
- Setting Up Your Adapter: deeper first-time setup and browser prompts
- Games & Tools: every supported game and utility
- Updating Firmware: web updater and manual UF2 flash
- LED Status Indicators: what the colors mean