ESboy – GAME BOY™ emulator

GAME BOY™ running in your browser. Compatibility List

Goal of this project is to write the GAME BOY™ CPU and rest of controllers (memory, gpu, timers, i/o etc) from scratch using ECMAScript 6, Canvas API and Web Audio API.

Play

• Try it online!
• Offline: clone/download this repository and open index.html in your browser.

Hardware accuracy

Blargg's CPU instructions tests:

Test	Result
Blargg test 1	✓
Blargg test 2	✓
Blargg test 3	✓
Blargg test 4	✓
Blargg test 5	✓
Blargg test 6	✓
Blargg test 7	✓
Blargg test 8	✓
Blargg test 9	✓
Blargg test 10	✓
Blargg test 11	✓

Develop

Build

• npm install
• npm run build

Run all tests

npm test

Run

Open index.html.

Run in console without a browser:

npm run cli -- -i <rom file> --debug

License

GNU GPLv3 License.

References

• Game Boy Programming Manual
• Gameboy LR35902 opcodes
• Gameboy CPU Manual
• Pan docs
• awesome-gbdev repository
• Imran Nazar's Gameboy Emulation in JavaScript
• gbdev.gg8.se