GAME BOY COLOR EMULATOR
playboy
Playboy — a Rust-based Game Boy emulator ported to run as a .pdx app on the Panic Playdate. It uses the gbrs Rust Game Boy core and Playdate platform bindings to run Game Boy ROMs on the handheld.

WHY IT MATTERS
Why this project exists
Playboy packages a Rust Game Boy implementation into a Playdate app so Game Boy titles can be run on the Panic Playdate hardware. It is primarily a platform port (Playdate frontend) around the author's gbrs Game Boy core.
BEST FOR
Best for
Playdate owners who want a compact Game Boy emulator running natively on their device and developers wanting an example of porting a Rust Game Boy core to the Playdate.
The people behind playboy
History & status
Playboy is authored by Adam Soutar and published on GitHub. The repository documents that the Playdate app is powered by Soutar's gbrs Rust Game Boy emulator core and uses crankstart Playdate bindings. The project is published with releases (prebuilt .pdx bundles) on GitHub and has visible recent activity in the repository and a releases page, indicating it is maintained. The repository includes source, docs and a README with platform-specific notes (for example a macOS Gatekeeper workaround).
What playboy supports
- Nintendo Game Boy (via the gbrs core)
- Panic Playdate (device target; .pdx application bundle)
- Bring-your-own ROMs (user must supply game ROM files)
- Playdate controls: D-pad, A/B; crank mapped to Start/Select
Download and availability
OFFICIAL DOWNLOADS
Get playboy
Official downloadable .pdx application bundles are published on the project's GitHub Releases page. Source is available on GitHub for building from source.
Get playboy ↗DOCUMENTATION
Official documentation
Read the official configuration, compatibility, and troubleshooting material before changing advanced options.
Read official documentation ↗playboy setup guide
Setup note: Practical setup notes — the README and releases are the authoritative sources. Below are concrete steps to get Playboy running on a Playdate device and common troubleshooting pointers drawn from the project README and releases.
- 1) Get the release .pdx: Open the project's Releases page and download the provided .pdx package for Playboy. The repository explicitly points users to the Releases page for prebuilt .pdx files.
- 2) Transfer the .pdx to your Playdate: Use the Playdate desktop/mobile app or your preferred Playdate deployment method to install the .pdx to the device. The .pdx is the Playdate application bundle format the README references; follow the Playdate documentation for installing third‑party .pdx files if you need platform-specific transfer steps.
- 3) Supply your own ROM files: On first run Playboy will state 'No game ROM found'. You must supply Game Boy ROM files yourself — the project does not include any commercial games, BIOS, or firmware. Place your legally obtained ROM files in the location the Playdate app scans (follow the README 'these steps' link or your Playdate file layout).
- 4) Controls and crank usage: Directional pad and A/B map to their expected Game Boy inputs. The Playdate has fewer buttons than a Game Boy; Playboy maps Start and Select to the Playdate crank (turn clockwise for Start, counter-clockwise for Select) as documented in the README.
- 5) macOS gatekeeper note (if applicable): If macOS refuses to open the .pdx due to a library being blocked (pdex.dylib), the README documents a Finder workaround: right-click the .pdx, Show Package Contents, right-click pdex.dylib, choose Open, then confirm the Open dialog. This is a project-provided workaround noted in the repository README.
- 6) Building from source (developer): The repository contains the full source (Cargo.toml, src, and a Crank.toml) and references the gbrs core plus crankstart bindings. If you plan to build a custom .pdx, use the project source and the Playdate Rust/tooling guidance; consult the repo's Cargo.toml and Crank.toml for dependency and build hints.
- 7) Troubleshooting and updates: If you encounter problems or want the latest build, check the project's GitHub Issues and Releases for fixes. The README and repository activity are the authoritative places for status and instructions.
Software reminder: Playboy does not include game ROMs, BIOS, or firmware. You must provide any commercial game ROMs yourself and follow applicable copyright laws.
Sources and further reading
Detailed guides and tutorials
Explore step-by-step guides for playboy as they are published.
Retro Replay Retro Gaming History, Reviews & Emulation