Parrot Cart pluginsGet a Parrot Cart

Game Boy

Emulator for the handheld console

The details page on the cartGB.CVP

On the TV

These are the author’s screenshots, shown pixel for pixel.

Game Boy on the TV, picture 1 of 2
Picture 1256 × 192
Game Boy on the TV, picture 2 of 2
Picture 2256 × 192

README on the cart

This is what the cart shows for this plugin. It’s 101 lines long and 30 characters wide.

On the cart’s details page2,107 bytes

Plain text

GAME BOY

This plugin plays Game Boy and
Game Boy Color games on the
ColecoVision.

SETUP

Copy GB.CVP into the /PLUGINS
folder on the card. Put your
.gb and .gbc files in /gb, or
anywhere else on the card.
Pick one in the menu to play
it.

USB pads need a powered hub on
the cart's USB port, because
the cart can't power them. A
Switch Pro Controller or a
plain HID pad works.

CONTROLS

On the ColecoVision
controller:

- The joystick is the D-pad.
- Left fire is B, and right
  fire is A.
- Keypad # is Start, and
  keypad * is Select.
- Keypad 1 to 5 pick the
  colors. 1 is pea soup, 2 is
  gray, 3 is sky and 4 is
  sunset. 5 is full color, for
  Game Boy Color games.
- Hold keypad 7 for a second
  to save a state, or 9 to
  load it.
- Press RESET on the console
  to go back to the menu.

On a USB pad:

- The D-pad or the left stick
  is the D-pad.
- The right face button is A,
  and the bottom one is B, as
  on a Nintendo pad.
- Plus is Start, and minus is
  Select.
- L and R step back and
  forward through the colors.
- Hold ZL for a second to save
  a state, or ZR to load it.

A second pad controls the game
too.

SAVES

- Battery saves go next to the
  game, with the same name, so
  Zelda.gb saves to Zelda.sav.
  Other emulators use the same
  files. The cart writes them
  as the game changes them and
  when you press RESET.
- A save state holds the whole
  Game Boy. It goes next to
  the game as a .state file,
  one for each game.
- While you hold 7 or 9, the
  border turns yellow. Then it
  turns green when the state
  is saved, cyan when it's
  loaded, or red if it didn't
  work.

CREDITS

- Peanut-GB 1.3.0 by Mahyar
  Koshkouei, under the MIT
  license. The source is at
  https://github.com/deltabear
  d/Peanut-GB
- Game Boy Color support from
  Peanut-GB's cgb branch, by
  froggestspirit, adapted by
  Tomas Vecera.
- minigb_apu by Alex Baines
  and Mahyar Koshkouei, from
  Peanut-GB's examples, under
  the MIT license.
- TinyUSB by Ha Thach, under
  the MIT license. The source
  is at
  https://github.com/hathach/t
  inyusb
- The plugin itself is by
  Parrot Cart.

cart-readme.txt

README

This is the README.md from release v0.1.3. Images show up as links.

Game Boy

This plugin plays Game Boy and Game Boy Color games on the ColecoVision.

Setup

Copy GB.CVP into the /PLUGINS folder on the card. Put your .gb and .gbc files in /gb, or anywhere else on the card. Pick one in the menu to play it.

USB pads need a powered hub on the cart’s USB port, because the cart can’t power them. A Switch Pro Controller or a plain HID pad works.

Controls

On the ColecoVision controller:

  • The joystick is the D-pad.
  • Left fire is B, and right fire is A.
  • Keypad # is Start, and keypad * is Select.
  • Keypad 1 to 5 pick the colors. 1 is pea soup, 2 is gray, 3 is sky and 4 is sunset. 5 is full color, for Game Boy Color games.
  • Hold keypad 7 for a second to save a state, or 9 to load it.
  • Press RESET on the console to go back to the menu.

On a USB pad:

  • The D-pad or the left stick is the D-pad.
  • The right face button is A, and the bottom one is B, as on a Nintendo pad.
  • Plus is Start, and minus is Select.
  • L and R step back and forward through the colors.
  • Hold ZL for a second to save a state, or ZR to load it.

A second pad controls the game too.

Saves

  • Battery saves go next to the game, with the same name, so Zelda.gb saves to Zelda.sav. Other emulators use the same files. The cart writes them as the game changes them and when you press RESET.
  • A save state holds the whole Game Boy. It goes next to the game as a .state file, one for each game.
  • While you hold 7 or 9, the border turns yellow. Then it turns green when the state is saved, cyan when it’s loaded, or red if it didn’t work.

Credits

  • Peanut-GB 1.3.0 by Mahyar Koshkouei, under the MIT license. The source is at https://github.com/deltabeard/Peanut-GB
  • Game Boy Color support from Peanut-GB’s cgb branch, by froggestspirit, adapted by Tomas Vecera.
  • minigb_apu by Alex Baines and Mahyar Koshkouei, from Peanut-GB’s examples, under the MIT license.
  • TinyUSB by Ha Thach, under the MIT license. The source is at https://github.com/hathach/tinyusb
  • The plugin itself is by Parrot Cart.

Build it yourself

You need the Raspberry Pi Pico SDK 2.1.1, an Arm GNU toolchain, CMake, Ninja, Python 3, sjasmplus and picotool. Releases are built with the Arm GNU Toolchain 9-2019-q4 (GCC 9.2.1) and picotool 2.3.1. With those you get the same file, byte for byte.

cmake -B build -G Ninja -DPICO_SDK_PATH=$HOME/pico-sdk
ninja -C build

This makes build/GB.CVP. Copy it into the /PLUGINS folder on the card.

On Ubuntu, tools/ci/setup.sh installs the same tools that GitHub uses to build each release.

CART-README.md is the text the cart shows on the plugin’s page. It is the start of this README.

License

The plugin is under the MIT license (LICENSE). THIRD-PARTY.md lists the parts that came from elsewhere, and their licenses.

Release details

We read these from GitHub when the plugin was listed.

Release
v0.1.3, 2026-11-19
Image
143,360 bytes, loaded into RAM
Plugin API
1
GitHub
plasticbugs/parrot-plugin-gameboy
Source
Code at v0.1.3
License
MIT License
Credits
Peanut-GB 1.3.0 by Mahyar Koshkouei, under the MIT license. The source is at https://github.com/deltabeard/Peanut-GB; Game Boy Color support from Peanut-GB’s cgb branch, by froggestspirit, adapted by Tomas Vecera.; minigbapu by Alex Baines and Mahyar Koshkouei, from Peanut-GB’s examples, under the…
SHA-256
b4bc63d482068fc9f0799d8576f1cd62bad8c9a7d3b106ad559e2b93f67808c6

The code

Every plugin here has a public repo on GitHub, so you can read how it works.

GitHubplasticbugs/parrot-plugin-gameboyEmulator for the handheld consoleMIT LicenseRelease v0.1.3Browse the code

Release notes

The newest version is first.

Put it on your cart

  1. Download GB.CVP

    The SHA-256 is above if you want to check the file.

  2. Copy it to /PLUGINS

    That folder is on the cart’s microSD card.

  3. Put your files in /gb

    Your .gb .gbc files go in this folder.

  4. Start it

    Pick one of your files on the SD card and press A.