Skip to content

shenawy29/oxyboy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Oxyboy

Oxyboy is a partially-implemented Gameboy emulator written in Rust, using WebGPU and Egui/Eframe for rendering and window handling. This is a work-in-progress project. The only mapper emulated is MBC1, which allows most games to run.

To find games, go to emulatorgames.net. Here is link for Tetris.

image

Features

Full CPU instruction set emulation (including fetch-decode-execute loop).

Platform-independent rendering using Wgpu.

Installation

To build and run Oxyboy locally, you'll need the Rust toolchain.

Build Instructions

Note

For Nix users, there is a flake ready for you.

1. Clone the repository:

git clone https://github.com/shenawy29/oxyboy.git
cd oxyboy

2. Install dependencies:

cargo build --release

3. Run the binary:

cargo run --release

Keybindings

Key on Keyboard Emulator Key
Z A
X B
Up/Down/Left/Right Up/Down/Left/Right
K/J/H/L Up/Down/Left/Right
Space Select
Return/Enter Start

Roadmap

  • Sound emulation
  • Save games
  • WASM release

Credits

About

A partially-implemented Gameboy emulator written in Rust.

Resources

License

Stars

Watchers

Forks

Packages

No packages published