# GBOxide [](https://travis-ci.com/StarlitGhost/GBOxide) [](https://crates.io/crates/gboxide)
A GameBoy Emulator written in Rust
## Download [](https://github.com/StarlitGhost/GBOxide/releases/latest)
## Launch Instructions
Run from the command line with a ROM file, like so:
`$ ./gboxide roms/game.gb`
## Controls
* DPad: Arrow Keys
* A: x
* B: z
* Start: Return
* Select: Space
## References
Most of these are linked from [avivace/awesome-gbdev](https://github.com/avivace/awesome-gbdev#documentation), but these are the resources I've found most useful.
- [Pan Docs - GbdevWiki](http://gbdev.gg8.se/wiki/articles/Pan_Docs)
- [Gameboy (LR35902) OPCODES](http://www.pastraiser.com/cpu/gameboy/gameboy_opcodes.html)
- [GameBoy CPU Manual](http://marc.rawer.de/Gameboy/Docs/GBCPUman.pdf)
- [GameBoy Crib Sheet](http://gbdev.gg8.se/files/docs/GBCribSheet000129.pdf)
- [Cycle-Accurate Game Boy Docs](https://github.com/AntonioND/giibiiadvance/blob/master/docs/TCAGBD.pdf)
- [Official GameBoy Programming Manual](https://archive.org/download/GameBoyProgManVer1.1/GameBoyProgManVer1.1.pdf) (less relevant for emulation but still a handy resource)
## Test Roms
- [Blargg's](http://gbdev.gg8.se/files/roms/blargg-gb-tests/)
- [Gekkio & Wilbert Pol's](https://gekkio.fi/files/mooneye-gb/latest/tests/)