19 releases
0.2.8 | May 9, 2020 |
---|---|
0.2.6 | Mar 15, 2020 |
0.1.9 | Dec 22, 2019 |
0.1.7 | Nov 26, 2019 |
0.1.1 | Dec 28, 2017 |
#262 in Emulators
61 downloads per month
230KB
6.5K
SLoC
GameBoy Emulator
This is a GameBoy emulator written in Rust. It can be compiled to native and web assembly, see the build section for more details.
Emulator supports sound, several hardware types, RTC, gameboy color emulation, sprites, and saving to browser local storage (web) and user config directories (native)
The web assembly port is currently hosted here
Screenshots
Installing
The native version is published to crates.io and can be installed by running:
cargo install gameboy_opengl
Then you can run it by running: gameboy_emulator
from your terminal
Building from source
The project uses Cargo as a build system, so building the project is relatively simple.
Native
cargo build --package gameboy_opengl --bin gameboy_emulator --release
this produces the executable target/release/gameboy_emulator.exe
to run it, just supply the rom file as the first file argument
Web Assembly
cargo-web
is very useful for building the web
port of the emulator.
cargo-web deploy --release
use your favorite static file server to serve the files generated in the
target/deploy
directory. You can also run cargo-web start --release
, to serve the files locally.
Dependencies
~19MB
~377K SLoC