Gambatte-speedrun

Emulator r717

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 Mac OS X - macOS Intel x86 Intel x86 64-bit 64-bit

Download and links

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.

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum