Retro hardware libraries in .NET Core with an Angular front end
Switch branches/tags
Nothing to show
Clone or download
axle-h Updates and minor fixes
* Angular 5.1.2 -> 5.2
* Bootstrap 4.0-beta -> 4.0
* Latest NuGet releases
* Now displays joining messages
* Replayed messages are now ordered correctly
* Switched out nlog for serilog - cleaner dev/prod config
* Fixed an unhandled exception when disconnecting the socket
* Updated README
Latest commit 4ae2af3 Mar 10, 2018

Build Status


Retro hardware libraries in .NET core.


To run a GameBoy on ASP.NET Core in a docker container:

docker container run -p 2500:2500 alexhaslehurst/server-side-gameboy

Then browse to localhost:2500.

See the included docker-compose file for running this behind a secure reverse proxy.


See it running on Azure.

I'm using my MSDN license to run it in Azure on a Basic A1 instance (1 Core, 1.75 GB memory) so the performance isn't great and this isn't even guaranteed to be up 24/7 according to M$.


I have written a few blog posts about this project, please take a read:

  1. Emulation on .NET
  2. Emulating the GameBoy CPU on .NET

Scott Hanselman has also blogged about it.


  • Z80 based CPU and MMU configurable for 8080, Z80 and GameBoy.
    • Simple interpreted core.
    • "Dynamically Re-compiling" core. Instead of executing each block of Z80 operations immediately, it builds an expression tree representing the block, which can be cached for increased speed. It's about 2.5x faster than the simple interpreted core. And far cooler.
  • Complete Z80 instruction set decode tests.
  • Complete Z80 execution tests.
  • Integration tests for the GameBoy Blargg test roms.
  • WIP GameBoy hardware. Just enough to play Tetris at full speed!
  • An Angular user interface using websockets. See gameboy-client.

Known issues

  • Timing is completely broken on desktop Hyper-V (Windows 10) resulting in the emulation running way too fast. Docker for Windows runs on Hyper-V so it is also affected.


  • GameBoy sound.
  • Improved GPU rendering to support games other than Tetris. E.g. transparent sprites, 8x16 sprites.
  • Debugger.