Gambit: a gameboy emulator

A work-in-progress gameboy emulator made using C#, WPF and OpenTK

Table of Contents

1. About The Project
2. Running From Source
   • Prerequisites
   • Instructions
3. Screenshots
4. License

About The Project

This is an emulator for the original gameboy (also referred to as the DMG), an 8-bit handheld game console, developed and produced by Nintendo in the 90s. It supports many (read: the few that I could get working) games that the original DMG did, such as Tetris, Pokemon Red and Monopoly (all definitely absolutely legally acquired roms!).

There's a core library project housing the logic for the gameboy processor, video system, address bus etc. and two frontend UIs built using WPF (windows only) and OpenTK (cross platform desktop).

It's a total work-in-progress, and games (even the ones that run instead of crashing) are often glitched. So keeping expectations low is good, if you decide to clone this repository.

No roms included though! So you'll have to, uh... source your own.

Running From Source

To get this project running locally from source, follow these steps:

Prerequisites

• .NET SDK (>= 6.0)
• Visual Studio / VS Code (+ C# extensions)

Instructions

1. Clone the repo

   git clone https://github.com/DevChrome/Gambit.git

2. Navigate to either of the UI directories

   cd Gambit.OpenTKUI

   OR

   cd Gambit.WpfUI 

3. dotnet run the project

   dotnet run

Screenshots

License

Distributed under the MIT License. See LICENSE.txt for more information.

[Back To Top]