$git clone https://github.com/drhelius/GearboyGearboy is an accurate, cross-platform Game Boy / Game Boy Color / Super Game Boy emulator written in C++ that runs on Windows, macOS, Linux, BSD and RetroArch, with an embedded MCP server for debugging and tooling.
| 1 | # Gearboy |
| 2 | |
| 3 | [](https://github.com/drhelius/Gearboy/actions/workflows/gearboy.yml) |
| 4 | [](https://github.com/drhelius/Gearboy/releases) |
| 5 | [](https://github.com/drhelius/Gearboy/commits/master) |
| 6 | [](https://github.com/drhelius/Gearboy/graphs/contributors) |
| 7 | [](https://github.com/sponsors/drhelius) |
| 8 | [](https://github.com/drhelius/Gearboy/blob/master/LICENSE) |
| 9 | [](https://x.com/drhelius) |
| 10 | |
| 11 | Gearboy is an accurate, cross-platform Game Boy / Game Boy Color / Super Game Boy emulator written in C++ that runs on Windows, macOS, Linux, BSD and RetroArch, with an embedded MCP server for debugging and tooling. |
| 12 | |
| 13 | This is an open source project with its ongoing development made possible thanks to the support by these awesome [backers](backers.md). If you find it useful, please consider [sponsoring](https://github.com/sponsors/drhelius). |
| 14 | |
| 15 | Don't hesitate to report bugs or ask for new features by [opening an issue](https://github.com/drhelius/Gearboy/issues). |
| 16 | |
| 17 | <img src="http://www.geardome.com/files/gearboy/gearboy_debug_05.png"> |
| 18 | |
| 19 | ## Downloads |
| 20 | |
| 21 | <table> |
| 22 | <thead> |
| 23 | <tr> |
| 24 | <th>Platform</th> |
| 25 | <th>Architecture</th> |
| 26 | <th>Download Link</th> |
| 27 | </tr> |
| 28 | </thead> |
| 29 | <tbody> |
| 30 | <tr> |
| 31 | <td rowspan="2"><strong>Windows</strong></td> |
| 32 | <td>Desktop x64</td> |
| 33 | <td><a href="https://github.com/drhelius/Gearboy/releases/download/3.8.10/Gearboy-3.8.10-desktop-windows-x64.zip">Gearboy-3.8.10-desktop-windows-x64.zip</a></td> |
| 34 | </tr> |
| 35 | <tr> |
| 36 | <td>Desktop ARM64</td> |
| 37 | <td><a href="https://github.com/drhelius/Gearboy/releases/download/3.8.10/Gearboy-3.8.10-desktop-windows-arm64.zip">Gearboy-3.8.10-desktop-windows-arm64.zip</a></td> |
| 38 | </tr> |
| 39 | <tr> |
| 40 | <td rowspan="3"><strong>macOS</strong></td> |
| 41 | <td>Homebrew</td> |
| 42 | <td><code>brew install --cask drhelius/geardome/gearboy</code></td> |
| 43 | </tr> |
| 44 | <tr> |
| 45 | <td>Desktop Apple Silicon</td> |
| 46 | <td><a href="https://github.com/drhelius/Gearboy/releases/download/3.8.10/Gearboy-3.8.10-desktop-macos-arm64.zip">Gearboy-3.8.10-desktop-macos-arm64.zip</a></td> |
| 47 | </tr> |
| 48 | <tr> |
| 49 | <td>Desktop Intel</td> |
| 50 | <td><a href="https://github.com/drhelius/Gearboy/releases/download/3.8.10/Gearboy-3.8.10-desktop-macos-intel.zip">Gearboy-3.8.10-desktop-macos-intel.zip</a></td> |
| 51 | </tr> |
| 52 | <tr> |
| 53 | <td rowspan="5"><strong>Linux</strong></td> |
| 54 | <td>Ubuntu PPA</td> |
| 55 | <td><a href="https://github.com/drhelius/ppa-geardome">drhelius/ppa-geardome</a></td> |
| 56 | </tr> |
| 57 | <tr> |
| 58 | <td>Fedora RPM</td> |
| 59 | <td><a href="https://github.com/drhelius/rpm-geardome">drhelius/rpm-geardome</a></td> |
| 60 | </tr> |
| 61 | <tr> |
| 62 | <td>Desktop Ubuntu 24.04 x64</td> |
| 63 | <td><a href="https://github.com/drhelius/Gearboy/releases/download/3.8.10/Gearboy-3.8.10-desktop-ubuntu24.04-x64.zip">Gearboy-3.8.10-desktop-ubuntu24.04-x64.zip</a></td> |
| 64 | </tr> |
| 65 | <tr> |
| 66 | <td>Desktop Ubuntu 22.04 x64</td> |
| 67 | <td><a href="https://github.com/drhelius/Gearboy/releases/download/3.8.10/Gearboy-3.8.10-desktop-ubuntu22.04-x64.zip">Gearboy-3.8.10-desktop-ubuntu22.04-x64.zip</a></td> |
| 68 | </tr> |
| 69 | <tr> |
| 70 | <td>Desktop Ubuntu 24.04 ARM64</td> |
| 71 | <td><a href="https://github.com/drhelius/Gearboy/releases/download/3.8.10/Gearboy-3.8.10-desktop-ubuntu24.04-arm64.zip">Gearboy-3.8.10-desktop-ubuntu24.04-arm64.zip</a></td> |
| 72 | </tr> |
| 73 | <tr> |
| 74 | <td><strong>MCPB</strong></td> |
| 75 | <td>All platforms</td> |
| 76 | <td><a href="MCP_README.md">MCP Readme</a></td> |
| 77 | </tr> |
| 78 | <tr> |