Skip to content

emu-russia/dmgemu

Repository files navigation

Nintendo GameBoy Emulator

This is original "black-and-white" GameBoy (DMG-01) emulator. It supports variety of mappers, boot from internal ROM and has nice-looking LCD effect. Compatibility is pretty high.

It is very portable with minimal code modifications and can be used for educational purposes.

Controls:

  • Arrows: Arrows %)
  • A: SELECT
  • S: START
  • Z: B
  • X: A
  • Enter: press all buttons at once (to do game save or reset etc.)
  • F8: Switch frame limiter on/off
  • F9: Switch LCD effect on/off
  • F12: Turn sound on/off

Build for Windows

Use Windows and VS2022. Open dmgemu.sln and click the Build button with your left heel.

Build for Linux

In general, the build process is typical for Linux. First you get all the sources from Git. Then you call CMake/make

# Get source
# Choose a suitable folder to store a clone of the repository, cd there and then
git clone https://github.com/emu-russia/dmgemu.git
cd dmgemu

# Preliminary squats
mkdir build
cd build
cmake ..
make

# Find the executable file in the depths of the build folder
./dmgemu zelda.gb

If something doesn't work, you do it. You have red eyes for a reason. 🐧

Some screenshots

whc4e0b23f6744b0 whc4e0b23fd946e8

whc4e0b23ac916b8 whc4e0b23a683fc0

Enjoy! 😄

Thanks to E}|{, for invaluable help with LCD and sound!

Thanks to Gumpei Yokoi for this great handheld system and Nintendo for bunch of really awesome games.