Gameboy-Emulator-Rust

Project Screenshots

About

This project is a personal way for me to learn about computer systems and improve my programming skills. It is a software simulation of the Game Boy that aims to replicate the hardware behavior as accurately as possible.

Prerequisites

1. Install Rust from their official website

Running the Emulator

1. Clone the project using the following command git clone https://github.com/death7654/Gameboy-Emulator-Rust.git
2. Open a terminal, and cd to the project
3. Run cargo build
4. The emulator depends on SDL2 for rendering. To ensure it runs correctly, copy the contents of the dependencies folder into the target/debug folder:
   • Linux/macOS
     • cp dependencies/* target/debug/
   • Windows
     • Copy-Item dependencies\* target\debug\
5. In main.rs, change the first line in the main function to the path to your rom
   • let rom = std::fs::read("C:/path/to/rom.gb").unwrap();
6. Run cargo run

Features not implemented

1. Audio
2. Save game state
3. Game Boy Color Support
4. Game Boy Advance Support
5. High Level Useability Tools