FreeMe!GB

A GameBoy simulator written in Go. GUI bindings are written for GTK+. This program is designed to simulate the real hardware that was equipped in the system itself.

Features

Note: Features not yet implemented are italicized

• Debugging Utility
  • CPU Registers
  • OPCODE descriptions
  • Breakpoint debugging
• Emulation Core
  • ROMs
    • ROM Name
    • ROM Type
    • ROM Size
    • Compatibility Check
  • CPU
    • Decode ROM file into OPCODE map
    • Registers per hardware specifications
    • Interrupts per specifications
    • Throttle speed per hardware specifications
  • GPU
• Controller Support
• Shaders
• Installers
  • Supported Platforms:
    • Linux RPM, DEB, and AppImage
    • Windows MSI
    • OSX dmg

Build Requirements

• Windows
  • Install MSYS2 mingw64
  • Install Windows dependencies
  • Build by hand:
    • Add /mingw64/bin to $PATH
  • Clone repository
  • Navigate to repository and run go mod init
  • run make host or make windows_amd64
    • Note: if you wish to compile x86, add /bin/mingw32 to your $PATH instead
• Linux
  • Install Linux dependencies
• Mac OS X
  • Not planned

Project Inspiration

I have always interested in how emulators work, so I started to have this idea of creating my own emulator variant of the original GameBoy. This simulator is designed to be both educational and eventually complete. Please give me time as this is a personal project that may be dormant from time to time, depending on how life is at home. Feel free to give suggestions and tips at [email protected].

I look forward to completing FreeMe!GB and discovering Node.js's ability to perform.

Please check out the wiki for more information.