Skip to content
Warren William June Travis in Times Square Playboy - trailer (cropped screenshot)
Warren William June Travis in Times Square Playboy - trailer (cropped screenshot) Image by film trailer screenshot (Warner Bros.), via Wikimedia Commons (Public domain).

playboy

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.

game boy colorPRIMARY SYSTEM
History documentedPROJECT BEGAN
Open sourcePROJECT MODEL

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 ↗
Broken or missing download? Emulator projects move and official links sometimes change. Please contact Retro Replay so the source can be verified and updated.

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. 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. 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. 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. 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. 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. 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. 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.