GearBoy
GearBoy 3.6.1 is a Game Boy and Game Boy Color emulator written in C++ by Ignacio Sánchez Gines, with an Intel version also available on GitHub.
GearBoy is a precise Game Boy and Game Boy Color emulator, developed in C++ by Ignacio Sánchez Gines. It supports advanced features of the original consoles, such as specific cartridges (MBC1, MBC3, HuC-1, etc.), the Super Game Boy, and authentic visual effects (ghosting, LCD matrix effects). The emulator also includes practical tools like battery saves, game states, cheats (Game Genie, GameShark), and an integrated debugger with disassembly and breakpoints.
On macOS, GearBoy is available in two versions: one for Apple Silicon (ARM64) processors and one for Intel machines. It also supports compressed ROMs (ZIP) and link cables for local multiplayer. Although developed as an open-source project, it remains a performance- and fidelity-focused tool, ideal for players seeking an experience close to the original hardware.
Last updated:
Platforms
Architecture
Mac OS X - macOS
Apple Silicon
64-bit
SDL Library
Download and links
- Download GearBoy
- Official website
- Source code 1 222 GitHub stars
- License : GPL-3.0
- Command copied to the clipboard.
- Homebrew page
Version history
3.8.17
- Ajout d’un module d’enregistrement vidéo pour capturer les sessions d’émulation.
- Amélioration du rendu et de l’échelle d’affichage avec les DPI fractionnaires pour une meilleure précision visuelle.
- Intégration d’un CPU Profiler dans l’outil de débogage pour analyser les performances.
- Nouveaux événements de journalisation dans le débogueur : alertes sur les frames manquantes et dépassements de budgets sprites.
- Réduction de la taille des états de sauvegarde pour gagner de l’espace.
- Mise à jour de la base de données des manettes pour une meilleure compatibilité avec les périphériques.
- 🎥 Added video recording
- 🖥️ Improved fractional DPI display rendering and scaling
- ⚙️ [debugger] CPU Profiler
- ⚠️ [debugger] New trace logger events: missed frame and sprite budgets
- 💾 Smaller save states
- 🎮 Updated Game Controller DB
- 🐛 Bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.16...3.8.17
3.8.16
- Ajout du support pour Barcode Boy, un jeu Game Boy original.
- Intégration de huit nouveaux cartridge mappers (BHGOS, Rocket Games, Li Cheng, NT Old/NT New, GGB81, Hitek, VF001, Sintax).
- Implémentation du câble Link avec affichage dual dans RetroArch.
- Disponibilité des builds officiels pour Ubuntu 26.04.
- 🔢 Added Barcode Boy support
- 🎯 8 new cartridge mappers (BHGOS, Rocket Games, Li Cheng, NT Old + NT New, GGB81, Hitek, VF001, Sintax)
- 🔌 Added Link Cable support with dual screens in RetroArch
- 📦 Added Ubuntu 26.04 builds
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.15...3.8.16
3.8.15
- Amélioration de la synchronisation verticale (VSync) pour différents taux de rafraîchissement d’écran.
- Réduction du lag d’entrée sur les écrans fonctionnant à 120, 144 et 240 Hz.
- Optimisation de l’interface des cheats avec une meilleure lisibilité et accessibilité.
- Mise à jour de la base de données des manettes de jeu pour une compatibilité étendue.
- Renforcement des outils de débogage avec des fonctionnalités supplémentaires.
- 📱 New iOS App (in development)
- 🖥️ Better VSync at different refresh rates
- 🚀 Minimized input lag with 120, 144 and 240 Hz screens
- ⚡ Improved cheats window
- 🎮 Updated Game Controller DB
- ⚙️ Improved debugger tools
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.14...3.8.15
3.8.14
- Ajout du support pour le câble Game Link entre émulateurs.
- Intégration du mapper MBC6 (Net de Get) pour cartouches spécifiques.
- Implémentation du patch logiciel IPS pour modifier des ROMs.
- Amélioration visuelle du thème clair avec une meilleure lisibilité.
- Correction de multiples bugs et optimisations internes.
- 🔌 Game Link Cable support
- 🎮 MBC6 (Net de Get) mapper support
- 💾 IPS soft-patching
- 🎨 Improved light theme
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.13...3.8.14
3.8.13
- Ajout d’une option no-sprite-limit pour contourner la limite de sprites.
- Amélioration du record VGM avec un timing plus précis.
- Intégration des shaders Sharp Bilinear pour une meilleure qualité graphique.
- Optimisations de performance globales de l’émulateur.
- Mise à jour de la base de données des manettes pour plus de compatibilité.
- Renforcement du serveur MCP et du Trace Logger dans le débogueur.
- 🚀 Performance optimizations
- 👾 Added no-sprite-limit option
- 🎵 Improved VGM recorder with precise timing
- 🎨 Added Sharp Bilinear shaders
- 🧠 Improved MCP server
- ⚙️ Improved Trace Logger in debugger
- 🎮 Updated Game Controller DB
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.12...3.8.13
3.8.12
- Ajout d’une option en ligne de commande pour un mode portable.
- Amélioration de l’implémentation du serveur MCP pour un meilleur support réseau.
- Intégration du support VFS pour la compatibilité avec libretro.
- Optimisation de la compatibilité dans les environnements Dev Containers.
- Mise à jour de la base de données des manettes de jeu.
- 📂 Added command-line option for portable mode
- 🧠 Improved MCP Server implementation
- 🕹️ libretro VFS support
- 📦 Improved compatibility in Dev Containers
- 🎮 Updated Game Controller DB
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.11...3.8.12
3.8.11
- Amélioration de la conformité du protocole serveur avec gestion de la négociation et validation de version.
- Ajout d'annotations pour le comportement des outils dans le protocole.
- Renforcement de la fiabilité du transport HTTP et gestion des erreurs.
- Correction de nombreux bugs et optimisations diverses.
- 🧠 [mcp] Hardened server protocol compliance with version negotiation and validation
- 🧠 [mcp] Added tool behavior annotations
- 🧠 [mcp] Improved HTTP transport reliability and error handling
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.10...3.8.11
3.8.10
- Amélioration de la découverte et de l’ergonomie de l’outil MCP pour les agents.
- Ajout d’une option configurable pour le comportement de l’écran de veille.
- Correction de nombreux bugs et optimisations diverses.
- 🧠 Improved MCP tool discoverability and usability for agents
- 🖥️ Added configurable screen saver behavior option
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.9...3.8.10
3.8.9
- Ajout du support Run ahead pour réduire la latence d'entrée en jeu.
- Mise à jour de la base de données des contrôleurs de jeu intégrée.
- Association des extensions de fichiers ROM avec les applications macOS et Linux.
- Introduction du mode portable pour macOS, permettant une exécution hors installation.
- Correction de plusieurs bugs majeurs et améliorations techniques.
- 🚀 Run ahead support for reduced input latency
- 🎮 Updated Game Controller DB
- 📂 ROM extensions associated with macOS and Linux desktop apps
- 💾 Add macOS Portable Mode
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.8...3.8.9
3.8.8
- Ajout du support pour les synthaxes RGBASM et WLA-DX dans le décompilateur/désassembleur.
- Amélioration de la précision technique de l'émulation (sans précision du domaine concerné).
- Intégration d’un routeur d’outils optionnel pour réduire l’usage des tokens dans le serveur MCP.
- Prise en charge du Variable Refresh Rate (VRR) pour les interfaces graphiques.
- Correction de nombreux bugs et optimisations internes (sans détail spécifique).
- 🎯 Improved accuracy
- 🖥️ Variable Refresh Rate ready
- 🧠 Reduced token usage in MCP server with optional tool router
- ⚙️ Added RGBASM and WLA-DX syntaxes in disassembler
- 🤖 Agentic Workflows
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.7...3.8.8
3.8.7
- Amélioration de la précision de l'émulation sur les jeux compatibles.
- Optimisation du serveur MCP pour une meilleure gestion des communications réseau.
- Mise à jour de la base de données des manettes pour inclure de nouveaux contrôles.
- Correction de multiples bugs et améliorations mineures du comportement global.
- 🎯 Improve accuracy
- 🧠 Improved MCP server
- 🎮 Updated Game Controller DB
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.6...3.8.7
3.8.6
- Ajout d’un mode thème clair ou sombre optionnel pour l’interface utilisateur.
- Intégration de plusieurs mappers non licenciés pour améliorer la compatibilité ROM.
- Correction de nombreux bugs et optimisations générales du comportement.
- 🏳️ Optional Light or Dark theme
- 🗺️ Added more unlicensed mappers
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.5...3.8.6
3.8.5
- Ajout de shaders programmables avec des effets intégrés (DMG, LCD, fantôme, grille, flou) ou personnalisables.
- Correction de multiples bugs et améliorations non détaillées dans ce résumé.
- 📺 Programmable shaders, with built in shaders or custom: DMG, LCD, ghosting, grid, blur...
- 🐛 Many bug fixes and improvements
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.4...3.8.5
3.8.4
- Ajout de quatre nouveaux mappers : Wisdom Tree, M161, MMC1, MMC2 et Pokémon Jade pour une meilleure compatibilité.
- Amélioration générale de la précision de l'émulation.
- Correction de plusieurs bugs et fonctionnalités mineures non détaillées.
- 🎯 Improved accuracy
- 🗺️ New mappers: Wisdom Tree, M161, MMC1, MMC2, Pokemon Jade
- 🐛 Many bug fixes and minor features
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.3...3.8.4
3.8.3
- Ajout du support de rewind pour les sessions de jeu.
- Amélioration du serveur MCP et de la gestion des compétences.
- Optimisation du trace logger dans le débogueur.
- Base de données des contrôleurs de jeu mise à jour.
- Correction de nombreux bugs et améliorations mineures.
What's Changed
- ⏪ Added rewind support
- 🧠 Improved MCP server + skill
- 📓 Improved debugger trace logger
- 📦 RPM repo (experimental)
- 🎮 Updated game controller database
- 🐛 Many bug fixes and improvements
New Contributors
- @statico-alt made their first contribution in https://github.com/drhelius/Gearboy/pull/218
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.2...3.8.3
3.8.2
- Ajout du support pour le Super Game Boy, améliorant la compatibilité avec les accessoires Game Boy.
- Amélioration générale de la précision des émulations, notamment pour les jeux critiques.
- Optimisation du serveur MCP et des mécanismes de skill pour une meilleure gestion réseau.
- Correction de multiples bugs et améliorations mineures dans le code.
- 🎨 Added Super Game Boy support
- 🎯 Improved accuracy
- 👾 [libretro] Added webOS and Linux aarch64 support
- 🧠 Improved MCP server + skill
- 🐛 Many improvements and bug fixes
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.1...3.8.2
3.8.1
- Ajout de cinq nouveaux mappers : HuC1, HuC3, MMM01, MBC7 et TAMA5 pour une meilleure compatibilité matériel.
- Amélioration de la précision globale de l'émulation, notamment pour les jeux utilisant ces nouveaux mappers.
- Prise en charge des contrôles tilt (inclinaison) pour les jeux MBC7 via manette, souris ou stick analogique.
- Mise à jour du serveur MCP et de ses fonctionnalités pour une meilleure intégration avec les outils de débogage.
- Correction de multiples bugs affectant le comportement général et la stabilité de l'émulateur.
- 🎯 Improved accuracy
- 💾 New mappers: HuC1, HuC3, MMM01, MBC7 and TAMA5
- 🧠 Improved MCP server + skill
- 🎮 Tilt controls for MBC7 games with gamepad sensors, mouse and analog stick
- ⚙️ Improved debugger tiles and background windows
- 🎮 Updated game controller database
- 🐛 Many bug fixes
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.8.0...3.8.1
3.8.0
- Ajout d’un serveur MCP et d’un outil SKILL en mode tête haute pour le débogage et le hacking assistés par IA.
- Migration de l’application de bureau vers SDL3 et OpenGL 3, améliorant la compatibilité graphique.
- Redessine complet du débogueur avec de nouvelles fonctionnalités et fenêtres dédiées.
- Prise en charge du vsync pour les écrans à 120 Hz et 240 Hz.
- Ajout d’une option pour recharger les paramètres par défaut.
- Correction de nombreux bugs affectant la stabilité et le comportement général.
What's Changed
- 🎯 Improved accuracy
- 🧠 MCP server + SKILL with optional headless mode for AI assisted debugging and hacking
- 💾 Desktop app migrated to SDL3 + OGL3
- ⚙️ Completely redesigned debugger with new features and windows
- 🔈 Improved audio latency with configurable settings
- 🖼️ Improved fullscreen mode
- 🗒️ New option to load default settings
- 🖥️ Support for vsync in 120/240 Hz screens
- 🍺 Homebrew tap for macOS
- 📦 Ubuntu PPA repo
- 🐛 Many bug fixes
New Contributors
- @RipleyTom made their first contribution in https://github.com/drhelius/Gearboy/pull/204
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.7.5...3.8.0
3.7.5
- Ajout d’un enregistreur audio pour les musiques de jeu (VGM Recorder).
- Possibilité de définir des raccourcis personnalisés pour les boutons de manette.
- Amélioration de la correction des couleurs pour les jeux Game Boy Color.
- Prise en charge des chemins contenant des caractères UTF-8.
- Mise à jour de la base de données des contrôleurs de jeu.
- 🎵 VGM Recorder
- ⌨️ Custom shortcuts. Add shortcuts to gamepad buttons
- 🎨 Improve GBC color correction
- 🌎 Support for UTF-8 characters in paths
- 🎮 Updated game controller database
- 🐛 Bug fixes
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.7.4...3.7.5
3.7.4
- Ajout d’une option pour activer/désactiver la pause automatique lors de la perte de focus.
- Mise à jour de la base de données des manettes de jeu pour une meilleure compatibilité.
- Correction de bugs non détaillés dans le changelog.
- Remplacement de l’icône par défaut pour macOS.
- 🎮 Update game controller database
- ⏯️ Option to enable/disable pause on focus lost
- 🖼️ Update icon for macOS
- 🐛 Bug fixes
Full Changelog: https://github.com/drhelius/Gearboy/compare/3.7.3...3.7.4
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.