CrankBoy offers stable, full-speed Game Boy emulation on the Playdate
CrankBoy is a Game Boy emulator for Playdate based on based on the Peanut-GB emulator by deltabeard. It was recently released as a stable v1.0, and has since received a couple of updates. Its current features and limitations are as follows:
Features
Limitations
- Stable, full-speed Game Boy emulation (on both Rev A and Rev B devices)
- You can download cover art for your library from within CrankBoy.
- Cartridge data saves automatically.
- 44.1 kHz audio
- Multiple save state slots per game.
- Settings to fine-tune performance, visual appearance, and crank controls
- Support for softpatching .bps, .ips & .ups patch files. Instead of making a bunch of copies of a ROM for all the different ROM hacks you'd like to apply to it, you can use a single clean ROM and several patch files, each of which you can toggle from the settings. Instructions below.
- Conveniently browse and download ROM hacks directly from within CrankBoy.
- ROMs can access Playdate features via IO registers and are also scriptable with Lua or with C -- you can add native crank controls to a game if you have the technical know-how.
- Can be installed in "bundle" mode, containing just a single ROM. This lets you have your ROM(s) visible directly from the Playdate menu, instead of having to open the emulator. You can also release your own Game Boy ROM as a Playdate game this way. See "Bundle Mode," below.
- Currently, Game Boy Color games are not supported in general. However, many Game Boy Color games are able to run on the DMG (original Game Boy) -- CrankBoy should be able to play those games fine.
- Some DMG games don't work correctly. Please report any broken games.
- Audio is not accurate to sub-frame precision, so audio clips (like in Pokémon Yellow or The Chessmaster) will be unrecognizable or silent.
- Link Cable is not supported.
- The Playdate's screen cannot fully refresh at a consistent 60 frames per second. CrankBoy has a variety of options to work around this. By default, the display will only update at 30 Hz (though the game will still run at full speed). It's quite hard to notice the difference on the Playdate screen. Games which don't have scrolling backgrounds should be able to run at 60 fps just fine, though you'll need to enable that in the options. 60 fps interlaced is also possible.
- Although CrankBoy will notify you if an update is available, updates are not currently downloaded automatically. CrankBoy checks if one is available at most once per day, and this behaviour can be disabled by revoking network privileges from the Playdate's native settings menu.
- CrankBoy is not 100% stable. It's recommended that you make back-ups of your save files now and then.
On Bluesky, @deeb.bsky.social has shared a video of the emulator in action. You can find more about CrankBoy via its official GitHub repo linked below.















