Skip to content

itytophile/gebeh

Repository files navigation

gebeh

gebeh logo. Two Game Boys connected with a Link cable. There is a fried egg on them.

Pronounced gebeh.

gebeh is a browser based Game Boy (DMG) emulator with online multiplayer. You can try it here https://gebeh.ovh/

On Android, gebeh runs better on Chrome. gebeh is "accurate" enough to pass 31 Mealybug Tearoom tests and the majority of the mooneye acceptance test suite. It doesn't support all cartridge types but the support can easily be added (hopefully).

Screenshots

Tetris multiplayer Tetris multiplayer

Dr. Mario multiplayer Dr. Mario multiplayer

Bibliography

General resources

CPU important details

  • Game Boy CPU internals - Very helpful document to understand HALT and interrupt handling (and other things).

About PPU timings

Test roms

Reference emulators

  • Mooneye GB - Used for comparison to know why gebeh was failing some tests.
  • SameBoy - Used to see how roms are supposed to run. Still can't understand the code, but there are interesting comments about STAT.
  • Boytacean - Can be used in the browser directly. MBC and some instructions implementation stolen from here. (replaced with new code, thanks Boytacean!)
  • RGY no-std emulator - Used its PPU implementation to test the CPU at first.

Debugger & Disassembler

  • Gameroy. It's an emulator too! Used it to know what Snorpung demos were doing. Used as a reference to pass blargg sound test roms.

Stress test roms