Multiplatform Game Boy emulator
C Objective-C Other
Switch branches/tags
Nothing to show
Clone or download
Latest commit 990e7d9 Nov 15, 2015

README.md

Cinoop

A multiplatform Game Boy emulator written in C; currently available for: Windows, OS X, Linux based OSes, Nintendo DS, Nintendo 3DS, Nintendo GameCube, Sony PSP, and Sony PS4.

Read my article about writing Cinoop here.

Progress

CPU: All instructions are implemented,

GPU: Can display tile maps, and sprites. Palette swapping is not implemented yet, so some colours may be displayed incorrectly.

Memory: Support for 32KB ROMs, without mappers, only (Tetris and Dr. Mario),

Input: Supported,

Sound: None,

Games: Tetris is most likely the only playable game,

Windows version running Tetris

DS emulator running Cinoop

GameCube emulator running Cinoop

Ubuntu version running Tetris

PSP emulator running Cinoop

Video of PS4 verstion running Tetris

The DS version does not run full speed, and the Linux port does not yet support input.

Building

Just run make on the directory to build all binaries. You can also run make windows for just Windows, make ds for just DS, make gamecube for just GameCube, make 3ds for just 3DS, make linux for just Linux, make psp for just PSP, or make ps4 for just PS4.

Building the Windows version requires LDFS, and has been tested with MinGW, using another compiler may require some tweaking.

Building the DS version requires devkitARM and libnds, from devkitPro.

Building the GameCube version requires devkitPPC and libogc, from devkitPro.

Building the 3DS version requires devkitARM and ctrulib from devkitPro.

Building the Linux version requires X11, and the OpenGL development files. It has been tested with Ubuntu.

Building the PSP version requires the Minimalist PSP SDK.

Building the PS4 version requires PS4-SDK.

Building and running the OS X version requires XQuartz.

Usage

For Windows, OS X, and Linux, pass the ROM you would like to run as the first argument. You can do this by either dragging the ROM onto Cinoop, or starting it from the command line:

cinoop tetris.gb

To view the full debug log, you will need to redirect stdout to a file, like so:

cinoop tetris.gb 1>debug.txt

For PS4, the ROM is read from a USB flash drive as a raw image. Use Win32 Disk Imager or dd to write it for example.

For other versions, the ROM name is hard coded as tetris.gb.

Windows Controls

  • B: Z

  • A: X

  • Start: Enter

  • Select: Backspace

  • DPad: Arrow keys

  • Debug: Space

  • Reset (not finished yet): *

  • Quit: Escape

DS Controls

  • B: B
  • A: A
  • Start: Start
  • Select: Select
  • DPad: DPad

GameCube Controls

  • B: B
  • A: A
  • Start: Start
  • Select: Z
  • DPad: DPad

3DS Controls

  • B: B
  • A: A
  • Start: Start
  • Select: Select
  • DPad: DPad or Circle Pad

Linux Controls

(not supported)

OS X Controls

(not supported)

PSP Controls

  • B: Square
  • A: Cross
  • Start: Start
  • Select: Select
  • DPad: DPad

PS4 Controls

Use a DS as a wireless controller