gamekid

GAME BOY COLOR EMULATOR

gamekid

Gamekid is an open-source Game Boy emulator port that runs Game Boy (GB) software on the Playdate handheld. It uses the PeanutGB backend and is distributed as a Playdate .pdx application (prebuilt releases available) with source on GitHub.

Jump to download ↓Jump to setup guide ↓

gamekid emulator screenshot.

game boy colorPRIMARY SYSTEM

History documentedPROJECT BEGAN

Open sourcePROJECT MODEL

WHY IT MATTERS

Why use Gamekid?

Gamekid brings classic Game Boy titles and homebrew to the Playdate by packaging a compact GB emulator backend (PeanutGB) inside a Playdate app. It is intended for play on-device, with progress still being made on performance and features.

BEST FOR

Best for

Playdate owners who want to run Game Boy and Game Boy homebrew on-device and developers who want a small, efficient GB core they can build or contribute to for Playdate.

The people behind gamekid

History and status

Gamekid is a community-built project hosted on GitHub that layers the PeanutGB emulator backend into a Playdate application. The repository and project page indicate active development and community interest; maintainers list outstanding work such as sound support and FPS optimizations. Releases are published on the project's GitHub releases page. The project is explicitly not affiliated with Panic (maker of Playdate) or Nintendo.

What gamekid supports

Playdate (pdx app)
Runs Game Boy (.gb) ROMs — community/homebrew recommended
Builds from source using the Playdate SDK
Uses PeanutGB backend

Download and availability

OFFICIAL DOWNLOADS

Get gamekid

Prebuilt releases and source code are available from the project's GitHub releases page. Install by sideloading the .pdx package to a Playdate (Data Disk mode) or build locally with the Playdate SDK and Makefile.

Get gamekid ↗

DOCUMENTATION

Official documentation

Read the official configuration, compatibility, and troubleshooting material before changing advanced options.

Read official documentation ↗

Broken or missing download? Emulator projects move and official links sometimes change. Please contact Retro Replay so the source can be verified and updated.

gamekid setup guide

Setup note: This guide describes practical installation on a Playdate and building from source. Gamekid does not include commercial games, BIOS, or firmware — you must provide your own compatible .gb files (homebrew or legally obtained backups). Follow Playdate developer guidance and the project README when building.

Get the release or source: Download the latest prebuilt .pdx from the project's GitHub releases page (look for a .pdx artifact). If you prefer to build, clone the GitHub repository and follow the README build steps. You will need the Playdate SDK for building.
Sideloading a prebuilt .pdx to Playdate: 1) Reboot the Playdate to Data Disk mode: Settings > System > Reboot to Data Disk. 2) Connect Playdate to your computer via USB. 3) When the Playdate disk appears, copy the downloaded .pdx file into the root or an appropriate folder. 4) Eject/unmount the drive and reboot the Playdate. The Gamekid app should appear in the UI.
Installing ROM files (games): Create or locate a games folder for Gamekid on the Playdate Data drive: Data/<gamekid folder>/games. Copy your .gb files (homebrew or legally obtained files) into that folder. Unmount and start Gamekid; games in that folder should be listed. The project's README recommends homebrew sources such as itch.io and community hubs for GB homebrew.
Building from source (developer): 1) Install the Playdate SDK for your host platform and read Playdate's C API docs. 2) Clone the repository from GitHub. 3) If building on Apple silicon, install Rosetta if the toolchain requires it (project README notes this). 4) Run make in the repository root; the Makefile builds the .pdx using the Playdate SDK. 5) Copy the produced .pdx to your Playdate as above for testing. Follow README notes for Nova integration if you use that tool.
Practical notes and limitations: Gamekid uses PeanutGB, a compact emulator prioritizing efficiency over full accuracy. Expect missing features: sound support and performance (FPS) are listed as TODO items. Some games may run with reduced FPS or incompatibilities. The project is actively developed — consult the repository issues for current limitations and troubleshooting.
Contributing or troubleshooting: Open issues and pull requests on the GitHub repository. The README points contributors to the Playdate SDK docs and requests that changes be submitted via pull requests. For build problems on Apple silicon, the README advises installing Rosetta if necessary.

Software reminder: You must provide your own Game Boy ROM files and follow applicable laws when obtaining them. Building requires the Playdate SDK (official). The project does not include commercial games, BIOS, or Nintendo assets.