Gambatte-speedrun
Gambatte-speedrun is a Game Boy and Game Boy Color emulator derived from Gambatte, optimized for speedrunning, particularly for Pokémon games, in version r717 for macOS 10.13 and later.
This software no longer receives updates. Its last known release dates from March 9, 2020. Check that it still works with your version of macOS.
Gambatte-speedrun is a specialized emulator for speedrunning Game Boy and Game Boy Color games, derived from the Gambatte emulator. It includes targeted optimizations for competitions, particularly for Pokémon games, ensuring temporal parity with the original consoles (via the use of bootroms). The emulator removes non-essential features (turbo, cheats) and offers precise adjustments such as a cycle-based RTC clock or Super Game Boy emulation to accurately replicate game conditions.
Developed for macOS, it relies on Qt5 and can be compiled from source. While not officially optimized for Apple Silicon, it works on recent versions of macOS (from 10.13 onwards). Note that it is now obsolete in favor of the GSR emulator, but it remains a reference for demanding speedrunners.
Last updated:
Platforms
Architecture
Mac OS X - macOS
64-bit
Download and links
- Download Gambatte-speedrun
- Official website
- Source code 103 GitHub stars
- License : GPL-2.0
Version history
717
- Intégration des mises à jour de précision de 2019 de gambatte (corrections pour TCG, Crystal Clear, et autres jeux originaux).
- Prise en charge des hard resets subframe sur la plateforme Game Boy Player (comportement aligné avec la console).
- Correction des entrées simultanées Up+Down ou Left+Right pour respecter le comportement de Game Boy Player.
- Ajout d’un avertissement pour l’utilisation de Shift comme touche assignée (problèmes de combinaison avec des touches modifiées).
- Support officiel de macOS 10.13+ (fichiers .dmg fournis pour macOS, distincts des builds Windows).
- Création instantanée des fichiers .sav pour Gen 1/2 et TCG (en fin de routine d’enregistrement).
Note: If you download the Non-PSR version of Gambatte-Speedrun, select a platform other than Game Boy Player, and do a Pokémon speedrun on it, your run will be REJECTED from the leaderboards. PSR runners should use the attachment with PSR in its name, or be careful to have GBP selected for all attempts.
As usual, this release is a compulsory upgrade for runners submitting to our leaderboards. Note that there are two new .dmg files, which are Mac versions of GSR. If you are on Windows, download the .zip files as usual.
Includes the following changes (click here for full changelog):
Emulation accuracy
- Merged all 2019 upstream gambatte accuracy updates by sinamas (fixes TCG, Crystal Clear, perhaps others)
- Fixed emulation of some original Game Boy games (i.e. no GBC enhancements) on GBC/GBA/GBP (mostly affects non-Pokemon games)
Hard reset rework
- Subframe hard resets now supported on GBP platform (Gen 2 save corruption routes, TCG card duplication should have parity with console)
- Game audio now cuts immediately when the hard reset fade begins, to match GBP behavior
- Rare quirky behavior (e.g. resets that take 1 or many frames too long, or Blue NSC crash where hard reset was never processed) should be mostly mitigated
Input handling fixes
- Simultaneous Up+Down or Left+Right inputs now have proper "cancellation" behavior to match GBP
- Using the same keyboard/joystick input for multiple GB inputs is no longer possible (was already "not allowed")
- Fixed stray issues with German/Portuguese keyboard layouts (and perhaps others) that could cause numerous erratic behaviors
- Added warning when using Shift as a bound key (causes issues when used in combination with keys "modified" by Shift)
- Added a deadzone threshold configuration option for joystick users
Miscellaneous
- Added official support for macOS 10.13+; binaries will be added with the upcoming release
- Instant .sav creation for Gen 1/2 and TCG (at end of game's save routine)
- Initial bootrom "error message" for first-time users was made slightly more informative
- Fixed bug with default input settings for first-time users; other default settings also made more sensible
- Savestates from r649/r664 should remain unaffected by changes (autosplitters are mostly ok, but will need updating to detect the new gambatte_speedrun.exe program name)
r717
No details for this version.
664
- Amélioration de la précision du générateur de nombres aléatoires pour les jeux Game Boy Color de deuxième génération, synchronisant tous les exploits connus avec la console.
- Correction des sauvegardes pour Pokémon Crystal en japonais.
- Suppression des options de cadence de base et des commandes pour modifier/réinitialiser la vitesse, jugées inutiles pour les runs officiels.
- Rappel aux compétiteurs : les runs sur Pokémon hors de Game Boy Player seront rejetés des classements, sauf pour la version Non-PSR.
Includes the following changes:
- Improved RNG accuracy for gen2 games to where all known gen2 manips sync with console. (Yes, the same patch note as the last release, as our understanding of GB emulation has progressed further)
- Fixed saves for JP Crystal.
- Removed settings for base framerate and increase/decrease/reset framerate inputs. These functions have no use in legitimate runs and very little use in practice since fast forward is still available. If you have niche uses for base framerate changes such as 200% speed runs, you can continue to use the last release.
Note: If you download the Non-PSR version of Gambatte-Speedrun, select a platform other than Game Boy Player, and do a Pokémon speedrun on it, your run will be REJECTED from the leaderboards. PSR runners should use the attachment with PSR in its name, or be careful to have GBP selected for all attempts.
As usual, this release is a compulsory upgrade for runners submitting to our leaderboards.
649
- Précision accrue du générateur de nombres aléatoires pour les jeux Gen2, synchronisant tous les exploits connus avec la console.
- Correction de la temporalité des fondu au noir pour plus d’exactitude.
- Ajout d’un support basique du mapper HuC3 (utilisé par Robopon), incluant sauvegarde, horloge temps réel et activation à distance (sans support IR P2P).
- Option pour ouvrir le dossier de sauvegarde via l’explorateur système (Windows), inopérante si le dossier est lié à celui du ROM.
- Support étendu des plateformes (version Non-PSR) : DMG, GBC, GBA (sans fondu) et SGB2 (support partiel, limité à la RNG et couleurs écran).
Includes some fairly significant changes:
- Improved RNG accuracy for gen2 games to where all known gen2 manips sync with console.
- Improved accuracy of fadeout timing.
- Add rudimentary support for HuC3 mapper used by Robopon. Allows for saving, using the real-time clock and using the remote-activated functionality (P2P IR is not supported)
- Add "open save folder" option to have Windows Explorer (or equivalent) show you the folder where your saves are. Has no effect if you change the save folder to the option to use the same folder as the ROM, for now. This may be adjusted next release.
- (Non-PSR only) Added more platforms that you can emulate games on. DMG, GBC, GBA (same as GBP without the fadeout) and SGB2 (partial support, only really the things that are necessary to sync with console RNG-wise and colors on the main screen) are supported.
Note: If you download the Non-PSR version of Gambatte-Speedrun, select a platform other than Game Boy Player, and do a Pokémon speedrun on it, your run will be REJECTED from the leaderboards. PSR runners should use the attachment with PSR in its name, or be careful to have GBP selected for all attempts.
As usual, this release is a compulsory upgrade for runners submitting to our leaderboards.
614
- Ajout d’un fondu à l’extinction lors d’un redémarrage forcé pour reproduire le comportement du Gameboy Player et de l’interface logicielle.
- Correction de l’algorithme de génération de nombres aléatoires (RNG) pour les modèles Yellow et Gen2, basée sur des recherches communautaires et externes.
- Option activable pour utiliser des palettes en true color (simulant l’affichage du Gameboy Player) au lieu des palettes simulées pour la GBC.
- Optimisation de l’émulation de l’opcode stop pour améliorer son impact sur les speedruns.
Includes a couple of major features and two minor ones:
- Added a fadeout upon hard reset to imitate the behavior of the Gameboy Player and Gameboy Interface software.
- Improved accuracy of Yellow/Gen2 RNG, thanks to research by gifvex/entrpntr/ExtraTricky in our community and LIJI32/gekkio outside of it (in more technical terms, implemented a fix for this: https://twitter.com/gekkio/status/910225035763306502 )
- Added an option to use "true color" palettes (giving a picture similar to that from the Gameboy Player) instead of palettes that simulated a GBC screen.
- Improved emulation of the "stop" opcode with regard to its practical effect on speedruns.
This release is a compulsory upgrade for runners submitting to our leaderboards.
604
- Suppression de l’option permettant d’utiliser le RNG du Game Boy Color au lieu de celui de la GBA pour éviter les erreurs de configuration.
- Possibilité de réactiver cette option via un build define pour les développeurs intéressés.
- Annonce d’une future version binaire pour macOS (non encore disponible).
- Instructions de compilation pour Linux (Debian/Ubuntu) disponibles sur le site du projet.
Includes one minor quality of life improvement:
- Disabled the option to give Gameboy Color RNG (as opposed to GBA RNG) to remove any chance that people accidentally tick it and then fail to get RNG manipulation setups to work. Developers/other interested parties can still re-enable it by setting a particular build define.
Mac binary version might be coming soon, Linux users are encouraged to build from source. Some instructions for Debian can be found on the project homepage and they can be adapted to Ubuntu easily.
600
- Correction du comportement des arrêts corrompus pour les jeux comme Gold Glitched et des cas spécifiques du jeu 151.
- Ajout du numéro de build dans le message affiché lors d’un redémarrage forcé.
Includes some minor improvements/fixes:
- Corrupted stops now behave correctly (for Gold Glitched and obscure 151 stuff)
- Added the build number to the message shown on hard reset.
597
- Ajout d’un émulateur dédié avec RNG précis pour les speedruns Pokémon, incompatible avec un usage grand public.
- Nécessite un fichier BIOS GBC pour fonctionner, contrairement à la version originale.
- Recommandation explicite de privilégier Gambatte classique pour une utilisation occasionnelle.
This is the first "real" release of the Gambatte-Speedrun emulator with accurate RNG for use in the Pokemon Speedruns community.
This emulator requires a GBC bios image to function at all. For casual play, you should use the original gambatte instead.
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.