https://github.com/abusch/gb-rs
Yet another gameboy emulator in Rust
https://github.com/abusch/gb-rs
emulator gameboy gameboy-emulator rust rust-lang
Last synced: 6 months ago
JSON representation
Yet another gameboy emulator in Rust
- Host: GitHub
- URL: https://github.com/abusch/gb-rs
- Owner: abusch
- License: apache-2.0
- Created: 2022-02-10T05:31:13.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-02-06T14:04:54.000Z (8 months ago)
- Last Synced: 2025-03-24T03:11:25.887Z (7 months ago)
- Topics: emulator, gameboy, gameboy-emulator, rust, rust-lang
- Language: Rust
- Homepage:
- Size: 402 KB
- Stars: 13
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Yet another GameBoy emulator in Rust
This is my attempt to write a GameBoy emulator in Rust, to add to the pile of existing ones.
## How to run
At the moment, you need to have the DMG boot rom file and place it under `assets/dmg_boot.bin` to be able to compile and run the emulator.
Then simply run `cargo run --release -- path/to/rom.gb`.
Current keybindings:
- ↑, ↓, ←, →: Joypad
- A, B: A/B
- Enter: Start
- Space: Select
- ESC: Exit
- D: interrupt the program and start the command-line debugger
- S: Take a screenshot
## Current status
Seems to work fine with most MBC1+RAM games that I've tried.
## Still to do
- [ ] Allow building/running without the boot rom
- [ ] Support other MBCs
- [x] Sound
- [ ] Maybe compile to WASM?
## Screenshots
