SameBoy
SameBoy 1.0 emulates Game Boy, Game Boy Color, and Super Game Boy on Mac, with iOS and watchOS ports; the latest builds require macOS 10.12 or later.
SameBoy is a Game Boy, Game Boy Color, and Super Game Boy emulator designed for broad compatibility while prioritizing accuracy. Developed by Lior Halphon, it primarily targets macOS (with a minimum requirement of macOS 10.12), but also offers versions for iOS and watchOS. Its open-source code allows builds for other platforms like Windows or Unix systems.
Intended for both players and developers, SameBoy emphasizes technical fidelity (advanced debugging, save state management) and user-friendly features (scaling filters, graphical optimizations). Its intuitive interface and built-in tools make it a solid choice for exploring retro gaming heritage on Mac.
Last updated:
Platforms
Architecture
Mac OS X - macOS
Apple Silicon
64-bit
Metal
Download and links
- Download SameBoy
-
iOS version (1.0.5)
The offered file is version 1.0, while the latest published version is 1.0.5.
- Official website
- Source code 2 245 GitHub stars
- License : MIT
- Command copied to the clipboard.
- Homebrew page
Version history
1.0.5 App Store
- Correction du support des caméras et imprimantes dans l’émulation de l’iOS 27.
- Meilleure compatibilité avec les fichiers ZIP pour les ROMs et assets.
- Amélioration de la précision de l’émulation audio, réduisant les artefacts.
- Correction de bugs divers affectant la stabilité et le comportement.
* Fixed Camera and Printer support in iOS 27
* Improved compatibility with ZIP files
* Improved and more accurate audio emulation
* Various bug fixes
Complete change log: https://sameboy.github.io/changelog/
1.0.4 App Store
- Ajout du support officiel pour les jeux iPhone Duo et amélioration de la compatibilité avec iOS 27.
- Mise à jour du filtre CRT scaling avec une meilleure qualité visuelle.
- Corrections et optimisations pour une précision accrue dans l'émulation.
- Résolution de plusieurs bugs mineurs affectant le fonctionnement global.
- iPhone Duo support and improved iOs 27 support
- The CRT scaling filter has been updated with an improved look
- Various accuracy improvements
- Various minor bug fixes
Complete change log: https://sameboy.github.io/changelog/
1.0.3
- Correction d’un problème d’affichage de l’icône sur certaines versions de macOS.
- Suppression de code de débogage accidentellement inclus dans la frontend Cocoa.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- Added support for more controllers in the iOS frontend, including singular Joy-Cons
- Pressing buttons while in a locked rewind state now exits rewind mode in the iOS frontend
- The iOS frontend now handles save conflicts with a dialog, making syncing saves across different machines and emulators easier
- An
examine/xcommand can now use the/smodifier to change its output style to RGBDS-compatible assembly - An
examine/xcommand can now use$in its modifier to use hexadecimal count values - It is now possible to adjust the maximum rumble strength
- It is now possible to modify and save a running ROM file from the Memory Viewer in the Cocoa frontend
- Controller buttons can now be assigned to one of 4 hotkey commands in the iOS frontend
- Periodic saves were added to the iOS frontend
- A new screenshot hotkey was added to the SDL frontend
- Controller UI hiding in the iOS frontend can now optionally disable the centering of the game screen
- The Cocoa and SDL frontends now save the battery more frequently
Accuracy Improvements/Fixes
- Added silence detection to eliminate rounding artifacts when playing nothing but frequencies above Nyquist
- Prevented abnormal vblank events from updating the SNES-side buffers prematurely
- Fixed a bug that made reading the PCM registers non-deterministic when emulating a CGB in CPU revision C or older
- Fixed a bug that caused ROMs to be running in the background under some cases in the Cocoa frontend
- Fixed a bug that caused channel
PCM12to output incorrect channel 2 values when emulating CGB in CPU revision C or older - Improved the accuracy of the
PCMregisters when emulating CGB in CPU revision C or older - Emulated a new quirk where volume envelope ticks are delayed while emulating a CGB in CPU revisions D or E
- Corrected the channel alignment of channels 1 and 2 while emulating CGB in CPU revision C or older
- Fixed a bug where a volume envelope quirk that was only applicable to channels 1 and 2 was also applied to channel 4
- Major improvements to emulation of channel 4 start delays
- Emulated a quirk where one of channel 4's internal counters counts while the channel is inactive
- Emulated LFSR corruptions and "zombie steps" when writing to
NR43, including revision differences
Bug Fixes
- Fixed mouse cursor hiding behavior while debugging in the Cocoa frontend
- Fixed an issue where rewinding could reset the ROM under some circumstances in the iOS frontend
- Fixed a visual glitch in the reverse search functionality of the Cocoa debugger console
- Fixed a memory leak in scenarios where
getlinefails on some platforms - Fixed a resource leak in scenarios where loading a cheat file fails
- Fixed resource leaks in certain scenarios where loading a battery save or an ISX ROM fails
- Fixed a bug that caused the SDL frontend to be stuck on the greyscale palette
- Fixed a bug where starting an audio recording could crash on Windows on some systems
- Fixed a bug where the Game Boy Camera could not be emulated correctly on some iPhone models
- Fixed a spelling mistake in an iOS tip message
- Fixed a bug where certain versions of macOS did not display SameBoy's icon
- Fixed an issue that made it impossible to change the RTC mode in link mode in the libretro frontend
Misc Internal Changes
- Updated the boot ROMs so they can be built with the latest version of RGBDS
- Removed code for supporting legacy Windows save states from versions no longer compatible with modern versions of SameBoy
- Fixed compilation of the SDL frontend on
unsigned charplatforms - Made it possible to build the Cocoa frontend using older SDKs
- Removed accidentally committed debugging code from the Cocoa frontend
1.0.3 App Store
- Ajout du support étendu pour les manettes, incluant les Joy-Cons individuels.
- Dialogue intégré pour gérer les conflits de sauvegardes et faciliter leur synchronisation.
- Possibilité de régler l’intensité maximale des vibrations (rumble).
- Attribution de touches de manette à 4 commandes de raccourcis personnalisés.
- Amélioration significative de la précision de l’émulation du bruit (noise).
- Correction d’un bug où le retour arrière pouvait réinitialiser le ROM dans certains cas.
- Correction d’un dysfonctionnement de l’émulation de la caméra Game Boy sur certains modèles iPhone.
- Support for more game controllers, including singular Joy-Cons
- Better handling of save conflicts using a dialog, making syncing saves across different machines and emulators easier
- It is now possible to adjust the maximum rumble strength
- Controller buttons can now be assigned to one of 4 hotkey commands
- Major improvements to noise emulation accuracy
- Fixed an issue where rewinding could reset the ROM under some circumstances
- Fixed a bug where the Game Boy Camera could not be emulated correctly on some iPhone models
- Various other bugs fixes and improvements
Complete change log: https://sameboy.github.io/changelog/
1.0.2
- Ajout d’un débogueur (usage) affichant le temps CPU du Game Boy hors modes halt/stop, et d’un graphique CPU dans la fenêtre de débogage (interface Cocoa).
- Correction d’une erreur d’application du channel bias sur des canaux audio désactivés lors de l’émulation Game Boy Advance.
- Support d’un integer scaling avec bordures noires dans l’interface Cocoa (option similaire à celle de SDL).
- Configuration des boutons rapid A/rapid B sur contrôleur dans l’interface iOS.
- Deux modes V-sync optionnels ajoutés dans l’interface SDL.
- Améliorations UI/UX pour macOS et iOS 26 (nouveaux icônes, menu barre iPadOS 26).
- Correction du redimensionnement à l’échelle entière (via Zoom + Option) sur macOS récent.
- Correction de l’affichage des adresses dans le memory viewer (interface Cocoa).
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- New
usagedebugger command, displaying the Game Boy CPU's time outside of halt/stop modes - The debugger window in the Cocoa frontend now has a CPU usage graph
- The debugger
print/evalcommand no longer adds zero padding by default - The Cocoa frontend now has an option to force an integer scaling factor with black borders, similar to the SDL frontend
- The iOS frontend can now configure rapid A and rapid B buttons on a controller
- The SDL frontend now supports two optional V-sync modes
- The Cocoa and iOS frontends were updated with UI and UX improvements for macOS and iOS 26, respectively
- This also includes new icons when using on these operating systems, as well as on watchOS 26
- Minor UI improvements were also done for older versions of macOS and iOS
- SameBoy now supports the new menu bar on iPad OS 26
- Improved frame skipping during turbo mode
- Turbo mode can now have a configurable speed cap on all frontends
- In the iOS frontend, this supersedes the 200% and 400% overclocking-based turbo mode options
- Major improvements to audio quality, eliminating aliasing when playing high frequency tones
- The iOS frontend will now alert the user if automatic save states could not be created for some reason (e.g. lack of disk space)
- The iOS frontend will now ask for confirmations before resetting a ROM
Accuracy Improvements/Fixes
- Fixed an inaccuracy where the channel bias is applied to disconnected channel when mixing audio while emulating the Game Boy Advance
Bug Fixes
- Fixed a bug that caused certain GameShark codes to be imported incorrectly
- Pressing the Zoom button with alt/option pressed now resizes the window to the next integer scale even on newer macOS versions
- The debugger side view in the Cocoa frontend no longer scrolls to the bottom on longer outputs
- Fixed a bug that causes cheat search to crash when used on a ROM with no cartridge RAM
- Fixed a bug that prevented the Game Boy Printer from saving printed images to the iOS photo library
- Fixed a bug where certain addresses would be described incorrectly in the Cocoa frontend's memory viewer
- Fixed a bug that caused GBS files to play the boot ROM jingle upon loading instead of the first track
- Fixed a bug that made the cheat search window remain open even after closing its ROM
- Fixed a bug where imported ROMs were copied instead of moved, and vice versa, on iOS
- Fixed a bug where Cocoa's VRAM viewer would not show scrolling on some macOS versions
- Fixed a bug where emulation would not automatically resume after reaching the end of the rewind buffer on iOS
- Fixed a bug where the Cocoa frontend will fail update itself if it wasn't moved to the Applications folder
- The iOS fronted now correctly handles cases where a user tries to open a ROM from an internal iOS or SameBoy folder
- Mitigated a rare bug where certain actions could spontaneously reset a ROM on iOS
- Fixed a bug with the
GB_save_stateAPI where it returned success even on failures - Fixed a bug that prevented the binary releases of the Cocoa frontend from using the Mac's camera while emulating the Game Boy Camera
- Fixed a bug where the interface would rotate while playing motion-controlled games on some iOS devices
Misc Internal Changes
- Fix build on OpenBSD
- SameBoy's headers are now compatible with ANSI C and C++ compilation modes
- The
DISABLE_*flags can now be used while building subsets of thelibtarget, as well as the newly-addedheaderstarget - The Windows build process was changed to require Git Bash and Make instead of the GNUWin package
1.0.1
- Amélioration de la qualité audio en mode libretro avec rendu à 2 MHz et gestion du downsampling par le frontend.
- Ajout d’un mode faux analogique pour les joysticks externes en alternant les états des boutons D-pad.
- Correction de bugs liés aux transferts SGB sur plateformes big-endian (ex. Wii U).
- Prise en charge du débogage asynchrone étendue à Windows 7, 8.x et anciennes versions de Windows 10.
- Suppression d’un workaround pour un bug de RetroArch, améliorant le volume audio dans la portée Wii U libretro.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- UI improvements to the Cocoa palette editor
- Improved audio quality on libretro; audio is now rendered by SameBoy at 2MHz, and downsampling is now handled by the libretro frontend itself
- In the Wii U build, downsampling is still done by SameBoy
- With the meaning of register
$FF75discovered, it is now referred to asrPGBin the debugger - The output of the
watchpointdebugger command now includes the watchpoint type (read-only, write-only, or read-write)- This makes the default watchpoint type (write-only) more obvious
- Windows 11 users can now optionally disable rounded corners in the Graphics Options menu
- Official Windows builds no longer require installing MSVC runtimes by linking against
mvscrt.dll - Major improvements to debugging in the SDL frontend:
- The main emulator window is no longer unresponsive when the debugger is stopped
- Pressing keys in the emulator window while the debugger is paused now triggers a terminal bell
- On Windows,
sameboy.exeandsameboy_debugger.exehave been merged. Press Ctrl+C at any time to interrupt the debugger and open the debugger console, and close the console window at any time to resume normal gameplay. - Async debugging now supports all compatible versions of Windows, adding support for Windows 7, 8.x, and earlier builds of Windows 10
- When using an external controller, joysticks can now optionally be used as faux analog controls
- This feature quickly alternates D-pad buttons between pressed and release states to simulate analog inputs
- The SDL frontend will now automatically resize the window when switching between models and border modes as long as the window hasn't been manually resized
- A workaround for an old RetroArch bug has been removed, audio in the Wii U libretro port is now louder
- It is now possible to enable audio for both Game Boys in the Link Cable mode of the libretro port
Accuracy Improvements/Fixes
- OAM randomization is now more accurate
- Fixed a bug where certain SGB transfers would copy data incorrectly when running SameBoy on big endian platforms
- This fixes many SGB games suffering from garbled graphics when playing on the Wii U
- Fixed a potential accuracy issue when emulating MBC7 games
- The number of band-limited phases was increased in order to reduce overtones in high-pitched sounds
Bug Fixes
- New palettes will now appear on the Cocoa frontend even if the user have previously customized palettes
- Fixed a bug that caused the Pink Pop theme to modify itself once opened in the palette editor, in both the Cocoa and iOS frontends
- Fixed a bug where the vertical layout was not usable on certain iPads
- Resetting emulation in the SDL version while the emulator is paused will now resume emulation
- Fixed a bug where changing the emulated model in the SDL frontend does not immediately closes the menu
- Removed Unicode characters from libretro settings, as many frontends cannot display them
- Fixed a bug that caused ROMs to run without a window in the Cocoa port after changing the emulated revision
- Several iOS and watchOS crashes have been fixed
Removed Features
- Integration with the Homebrew Hub has been removed from the iOS frontend
Misc Internal Changes
- The OpenDesktop thumbnailer is now stripped when built in release configuration, rather than being stripped only upon installation
- Official releases of SameBoy now build using the latest version of Clang, gaining speed boost of around 8%
- The FM synthesis routines used while rendering the SGB jingle have been optimized for speed
1.0
- Ajout d’une version dédiée pour watchOS avec transfert de ROMs/saves depuis l’iOS, deux schémas de contrôle personnalisables, Fast Forward/Rewind et synchronisation des paramètres depuis l’iPhone.
- Amélioration de l’audio via un filtre band-passé en remplacement du box filter, améliorant la qualité sonore dans toutes les interfaces.
- Correction d’un bug bloquant l’émulation du câble Link sur macOS 10.13 et antérieur dans la frontend Cocoa.
- Prise en charge native des miniatures (via XDG Thumbnails) pour les fichiers ROM dans les environnements Open Desktop.
- Précision accrue des timings PPU (révisions CGB 0 à C) et gestion des conflits SCX, corrigant des artefacts visuels dans Mr. Chin’s Gourmet Paradise et Turrican.
- Mise à jour Quick Look pour macOS Sequoia, incluant de nouvelles API de prévisualisation et de miniatures.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- SameBoy for watchOS is now available:
- Transfer ROMs and saves to and from the iOS frontend (App Store only)
- Two customizable control schemes optimized for a small screen
- Fast Forward and Rewind support
- Settings and synced from the paired iPhone
- Available to active supporters or via a one-time payment
- The Cocoa frontend is now digitally signed and notarized
- SameBoy on Open Desktop platform can now generate thumbnails in file browsers via theXDG Thumbnails API
- Improved AirPlay Mirroring support in the iOS frontend
- Full-screen mode is now supported in the iOS frontend if a controller is used
- The Cocoa and SDL frontends now support automatic model selection
- Cheat Search is now available from the Cheats menu in the Cocoa frontend
- The user interface for the Cheats window has been improved in the Cocoa frontend
- The Cocoa and SDL frontends can now associate keyboard or joypad buttons with Rapid A or Rapid B
- Game Boy Printer can now be emulated in the iOS frontend
- Cheats can now be used in the iOS frontend
- iCloud support was added to the iOS frontend (App Store release only)
- The palette editor was added to the iOS frontend; it can now import, export and create its own palettes
- 7 new palettes were added to all frontends
- The horizontal layout on iPhones that have a notch has been improved
- 3 new interface themes were added to the iOS frontend (App Store release only)
- Improved ISX file compatibility
- The Cocoa frontend and now select a monospace font to be used in the debugger and other development windows
- The cartridge icons have been retouched and visually improved
- The SDL frontend on Windows can now associate itself with supported ROM files, and provide them with icons
- The box filter used for audio downsampling has been replaced with band-limited synthesis, vastly improving audio quality in all frontends
- A warning is now shown when loading a ROM with a RAM size smaller than a single bank
- iPhones that have x4 and x5 cameras can now pick a virtual x2 zoom factor when emulating a Game Boy Camera
- Improved the OAM viewer in the Cocoa frontend so it correctly show objects even when the object palette is all set to a single color
- Quick Look has been updated to support the newer thumbnailing and previewing APIs, required by macOS Sequoia
Accuracy Improvements/Fixes
- Improvements to OAM accessibility timings
- Improvements to PPU timings in CGB revisions 0 to C
- These revisions are no longer marked as "Experimental"
- More accurate emulation of SCX write conflicts on all models
- More accurate PPU fetcher timings, fixes visual glitches in in “Mr. Chin's Gourmet Paradise” and “Turrican”
- Improved accuracy of cases where WX is 166 on pre-CGB models
- Improved accuracy of window edge cases, including emulation of a newly-discovered CGB window glitch, and improved accuracy in double speed mode
- Improved accuracy of LYC edge cases when emulating CGB revisions 0 to C in double speed mode
- Improved emulation of LCDC OBJ_EN write conflicts
Bug Fixes
- Fixed a bug that caused the Mute menu item to incorrectly appear marked while a ROM is paused in the Cocoa frontend
- Fixed a bug that made keyboard shortcuts affect the wrong ROM in certain cases where multiple ROMs and debug windows were open in the Cocoa frontend
- Fixed a bug that prevented macOS 10.13 and older from using Link Cable emulation in the Cocoa frontend
- Fixed a bug that made importing palettes in the Cocoa frontend glitchy
- Fixed a bug that made Game Boy Camera emulation in the Cocoa frontend sometime incorrectly stretch the camera input to incorrect aspect ratios
- Fixed a bug that made audio output too low in the iOS frontend under certain conditions
- Fixed a bug that caused the Library in the iOS frontend to crash if ROMs were modified in the Files app while it was open
Misc Internal Changes
- The core now supports outputting 2MHz audio (without downsampling)
- The Quick Look plugin and the main application now share the same code on disk, making the Cocoa frontend slightly smaller
- Fixed a bug that caused certain APIs to return success values despite failing
- Improved thread and context safety assertions in the core
make libbuilds SameBoy as a dynamic library now, in addition to the previously available static library- This includes Windows support, which remains unsupported for static libraries
- Improvements to the core APIs. The API is now stable and documented
0.16.7
- Correction de la compatibilité des binaires macOS avec des versions antérieures de macOS via l'utilisation du SDK macOS.
- Correction des erreurs d'orthographe de "Game Genie" affichées comme "GameGenie".
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator.
New/Improved Features
- It is now possible to cycle between different main cameras on supported iPhone models in the iOS frontend
- The iOS frontend can now directly open ZIP archives
- ROMs can now be deleted from the iOS library using a context menu as well
- The Homebrew Hub in the iOS frontend was moved to a tab
- A new flat CRT filter is now available
- Retouched iOS icons, including support for dark and tinted icons
Bug Fixes
- Worked around a Wayland bug that sometimes caused SameBoy to crash it on exit
- Fixed a bug caused turbo/slow-motion/rewind modes to unexpectedly exit when using an external controller in the iOS frontend
- Prevented the console from flashing in the Windows version
- Fixed a bug when comparison operators had the wrong priority in the debugger
- Fixed a potential crash involving haptics in the iOS frontend
- Fixed a bug that caused the
deleteandunwatchcommands to list the wrong breakpoint/watchpoint after deleting one - Fixed more potential edge cases that could prevent the Cocoa frontend from opening files
- Fixed incorrect spellings of Game Genie as "GameGenie"
Misc Internal Changes
- Fixed an issue that made macOS binaries incompatible with some older versions of macOS when using the latest macOS SDK
- SDL2 has been upgraded for Windows releases
0.16.6
- Ajout de la possibilité de parcourir et télécharger des jeux/demos depuis Homebrew Hub dans l’interface iOS (uniquement les soumissions open-source pour l’instant).
- Amélioration des contrôles du D-pad en iOS : zone centrale neutre et suppression de la libération accidentelle lors d’un toucher hors zone.
- Correction des distorsions audio occasionnelles sur certains Mac et appareils iOS.
- Prise en charge du boot ROM utilisateur sélectionnable dans l’interface iOS.
- Correction d’un crash lors de la pause dans les frontends iOS et Cocoa.
- Correction de la fenêtre de console de débogage en Cocoa, qui ne s’affichait plus en mode "toujours au-dessus".
- Correction d’un régression 0.16.5 rendant la fenêtre Mémoire inutilisable sur macOS Sonoma (frontend Cocoa).
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator.
New/Improved Features
- You can now browse Homebrew Hub and download submitted games and demos directly in the iOS frontend.
- Currently, only open-source submissions can be viewed in-app. The ability to allow other submissions to appear in SameBoy will be added to Homebrew Hub soon.
- The option to open SameBoy's Library in the Files app has been added to the iOS frontend's Library screen.
- Screen dimming is now disabled while emulation is running in the iOS frontend.
- Improved D-pad controls in the iOS frontend – the center point of the D-pad is now a safe "rest" zone; dragging a touch outside of the D-pad no longer releases the button.
- User-provided boot ROMs can now be selected in the iOS frontend.
Accuracy Improvements
- Accuracy improvements to the square "zombie stepping" glitch in CGB-D and CGB-E, fixed Telefang title audio that was broken for these revisions.
- Writing to NRx3 and NRx4 in the same cycle these registers are read by the APU is now emulated correctly.
- SameBoy will now select
cgbE_boot.bin, if available, when emulating CGB-E.
Bug Fixes
- Fixed a bug that triggered occasional audio distortions on some Macs and iOS devices.
- Fixed a bug that made the iOS version sometimes incorrectly prefer SGB over CGB emulation for some newly imported ROMs.
- Fixed a bug that could crash SameBoy upon pausing in the iOS and Cocoa frontends.
- Fixed a bug that made the Cocoa frontend's Debug Console windows always on top.
- Fixed a 0.16.5 regression that broke the Cocoa frontend's Memory window on macOS Sonoma.
- Fixed stability issues when emulating the Game Boy Camera in the iOS frontend.
- Fixed a bug that caused haptics and rumble to temporarily stop working in the iOS frontend.
Misc Internal Changes
- Internal support for AGB-0's boot ROM was added to the core's API (AGB-0 remains unsupported as an emulated revision for now)
0.16.5
- Correction de l’affichage incorrect du mot "Version" dans les chaînes de version des interfaces Cocoa et iOS.
- Ajout du support des contrôleurs MFi, PlayStation, Switch et Xbox (rumble, mouvements, analogiques, remappage) dans la version iOS.
- Suppression d’un bug bloquant les iPad sous certaines conditions après quitter des écrans spécifiques.
- Correction d’un problème de transparence partielle dans les captures avec le filtre Monochrome LCD.
- Réglage automatique du modèle de Game Boy lors de l’import d’une ROM dans l’interface iOS.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator. This version's change set includes the changes from version 0.16.4, which was exclusive to the iOS App Store.
New/Improved Features
- The iOS frontend is now available on the App Store
- The App Store version requires iOS 13 or higher, while the version targeting side-loading and jailbroken devices still supports iOS 11 and 12.
- The following new features has been added to the iOS frontend:
- Support for MFi, PlayStation, Switch and Xbox controllers. Support includes rumble functionality, motion controls, analog controls, and button remapping.
- A launch screen was added.
- A new "Import ROM File" button was added to the Library screen.
- Multiple interface themes were added.
- The App Store version has additional themes that can be unlocked by supporting SameBoy's development.
- The iOS frontend now shows tips and facts in the pause menu.
- Tapping SameBoy's logo now opens the pause menu.
- The button haptics strength can now be changed.
- After importing a new ROM, a suitable model is automatically selected
- The default rewind duration in the Cocoa and iOS frontends was change to 2 minutes to match the SDL frontend.
- Debugger windows no longer hide when the Cocoa frontend is out of focus.
- Each debugger window now includes the ROM name in its titlebar in the Cocoa version.
Bug Fixes
- The Cocoa and iOS frontends no longer incorrectly include the word "Version" in their version strings.
- Fixed a bug that caused filtered screenshots to be saved as 32-bit per channel on the Cocoa frontend.
- Fixed a bug affecting iPads that left the game paused under some conditions after exiting certain screens.
- Fixed incorrect handling of loading save states of an incompatible MBC RAM size.
- Fixed a visual glitch with the Monochrome LCD scaling filter, which also caused filter screenshots to be semi-transparent.
- Fixed a bug that allowed rewinding auto-loaded states back to the boot ROM in the iOS frontend, potentially losing data.
- Fixed a bug that caused the camera-change button to be positioned incorrectly on notched iPhones running the iOS frontend.
Misc Internal Changes
- Fixed build issues when using the current master branch of RGBDS to build SameBoot.
- Fixed a false positive warning when using certain GCC versions.
- The iOS frontend's license has been updated.
0.16.3
- Ajout d’un changement de cartouche à chaud pour la version Cocoa, avec une option "Recharger ROM" accessible via Shift dans le menu Emulation.
- Correction de l’affichage incorrect de l’écran States sur iOS 16 et versions ultérieures.
- Suppression des artefacts visuels dans certains filtres de mise à l’échelle (multiples de 3) pour la version Cocoa.
- Mise à jour des ROMs SGB intégrées pour un timing plus proche des originales.
- Correction de la profondeur de couleur 64-bit dans les captures filtrées pour la version Cocoa.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- The “Hot Swap Cartridge” functionality now allows hot swapping a file with a newer version of itself in the Cocoa version
- This can also be done with the new “Reload ROM” menu item, available while holding Shift in the Emulation menu
- The SDL frontend now uses the modern folder selection dialog when selecting a boot ROMs folder on Windows
- Add an option to allow pressing A+B by touching the space between the two buttons in the iOS frontend
- The iOS frontend can now choose between 3 audio modes; Enabled, Disabled, and Controlled by Silent Mode
- The iOS IPA release is now ad-hoc signed to prevent TrollStore from signing it with the wrong entitlements
- The iOS Deb release is now compatible with both rootful and rootless jailbreaks
Accuracy Improvements/Fixes
- Updated the built-in SGB boot ROMs so they're closer in timing to the original boot ROMs
Bug Fixes
- The Cocoa and iOS versions now display the correct license for SameBoy
- Improved compatibility with certain ISX files
- Fixed the States screen displaying incorrectly in iOS 16 and newer
- Fixed several spelling mistakes in the debugger
- Fixed visual artifacts that may appear in certain scaling filters when scaling with a multiple of 3 factor
- Prevent filtered screenshots from using 64-bit color depth on the Cocoa frontend, which improves compatibility with certain apps
- The
ticksdebugger command no longer outputs “Tick count reset” if the keep flag was used - Fixed a bug that prevented Turbo Mode from working on iOS if dynamic speed controls were not enabled
Misc Internal Changes
- Improved integration with libretro's build infrastructure, which should greatly improve the release schedule of the libretro version of SameBoy
0.16.2
- Correction du mélange de trames en mode "Accurate" avec un suivi précis du "parity" et un ratio de fusion plus réaliste.
- Prise en charge des ROMs bootlegs indiquant une absence de RAM dans le champ MBC mais avec une taille RAM non nulle.
- Correction de l’affichage glitché des graphismes du menu dans l’interface SDL si une bordure est activée.
- Correction de l’affichage du changelog dans la boîte de mise à jour de l’interface Cocoa avec une police incorrecte.
- Restauration du support Quick Look sur macOS Sonoma.
- Suppression des problèmes de flickering dans les interfaces Cocoa et iOS avec le rendu Metal.
Accuracy Improvements/Fixes
- Improvements to the "Accurate" frame blending option; SameBoy now correctly tracks the "parity" of each frame, and uses a more realistic blending ratio
- Support for bootleg ROMs that claim to have no RAM in the MBC field, but also declare a non-zero RAM size
Bug Fixes
- Removed XAudio 2.7 support and replaced it with the redistributable version of XAudio 2.9, fixing various crashes on Windows 7
- Fixed an issue with the menu graphics being glitched in the SDL frontend if SameBoy is set to display a border
- Fixed the update dialog in the Cocoa frontend displaying the changelog in the wrong font on versions of macOS
- Fixed Quick Look support being broken on macOS Sonoma
- Fixed a bug where the Cocoa and iOS frontend would sometimes flicker when using the Metal renderer
0.16.1
- Correction de l’incompatibilité avec macOS 10.9 à 10.15 et résolution des problèmes d’UI du Printer Feed sur Big Sur et versions ultérieures.
- Désactivation automatique du VSync en dessous de 60 Hz dans l’interface SDL pour éviter des artefacts audio.
- Correction du blocage indéfini de l’interface SDL si le périphérique audio devient inutilisable avec le pilote XAudio 2.7.
- Empêchement des éléments de barre d’outils Cocoa de déborder et de provoquer un crash au clic.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- SameBoy on iOS will now warn the user if it hasn't been correctly signed, which could prevent "Open With" from working with SameBoy
Accuracy Improvements/Fixes
- Fixed a bug that made SameBoy think a WorkBoy was connected in some cases where a Game Boy Printer was connected
Bug Fixes
- Fixed a bug that made SameBoy incompatible with macOS versions 10.9 to 10.15
- Fixed several UI issues with the Printer Feed on macOS Big Sur and newer
- Prevent some Cocoa toolbar items from overflowing into a menu item that would crash on click
- Fixed a bug that prevented SameBoy from opening ROM files if VisualBoyAdvance was also installed on macOS
- VSync is now automatically disabled in the SDL frontend if the screen refresh rate is under 60Hz, which could cause garbled audio on some machines
- Fixed a bug where the SDL frontend would indefinitely hang if the current audio device became unavailable while using the XAudio 2.7 driver
Misc Internal Changes
- The iOS Deb releases no longer contain local file ownership information
- The SDL version used in the Windows release has been updated to 2.28.5
0.16
- Correction des artefacts sur les bords droit et inférieur de l'émulation de la Game Boy Camera sur certains Mac.
- Fix d'un bug empêchant la réouverture d'une ROM depuis le Finder dans l'interface Cocoa.
- Correction d'un problème de compatibilité des fenêtres entre versions de macOS (restoration des fenêtres après fermeture).
- Correction de l'affichage de la barre d'outils du VRAM viewer sur macOS Sonoma.
- Correction d'un bug bloquant l'ouverture de la fenêtre de préférences sur certains Mac lors de la compilation.
- Correction d'un problème de connexion automatique des contrôleurs dans l'interface SDL.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- A new, fully-featured iOS frontend:
- Supports every iPhone, iPad and iPod Touch model running iOS 11 or newer (iOS 13 or newer is recommended)
- Can be installed by side-loading (using AltStore or TrollStore) or using a jailbreak
- Innovative and customizable touch controls, including support for analog rewind, fast-forward and slow motion
- Save states
- Scaling filters
- In-game rumble support
- Game Boy Camera support
- Motion controls for supported games
- Notifications for alarm-clock-enabled games
- Advanced emulation settings
- A lot more!
- Reopening a ROM from Finder or other means now reloads the ROM in the Cocoa frontend
- The SDL frontend received a small facelift
- Cheats support in the SDL frontend
- The SDL frontend can now pick a specific revision from CLI
- A new
resetcommand in the debugger, supporting 3 types of resets - Several new changes that improved performance:
- Disabled inlining of several slow-path functions
- Enabled the compiler's fast-math flag
- Prevention of loop unrolling for large, non-speed-critical loops, to improve utilization of instruction caches
- Optimize the GUI code for size rather than speed to improve utilization of instruction caches
- Work around Clang and GCC generating slow code for inline compile-time constants
- Support for ranged breakpoints and watchpoints
- Breakpoints and watchpoints are now identified by a unique ID rather than an address, deletion is now done by ID
- The
IO_prefix for hardware registers in the debugger has been removed in favor of the more standardrprefix - The Cocoa memory viewer's "Go to" field can now switch banks and address spaces
- The Cocoa memory viewer now symbolicates its selection in the status bar
- The debugger now supports backwards single stepping, if rewinding is enabled (experimental)
- Sending
SIGUSR1to the SDL frontend now triggers a reset command - Improved controller assignment in the Cocoa frontend, especially when playing multiplayer SGB games or when emulating the link cable
- Menu and keyboard shortcuts to scale windows up and down to the next integer factor in the Cocoa frontend
- The Windows builds are now 64-bit, greatly improving performance on Windows
Accuracy Improvements/Fixes
- Emulation of open bus behavior when reading disabled cartridge RAM
- More accurate emulation of volume envelope locking on the pre-Color models, as well as CGB revisions older than D
- Improved Printer timings, allowing the mini game in Hello Kitty Pocket Camera to be played
- First-party Nintendo games will now have correct initial register values when using the built-in CGB and AGB boot ROMs
- Improved accuracy of
JOYPswitching delay - Fixed a timing issue when aborting an object fetch using an
LCDCwrite - Improvements to object fetching address calculation timings
- Accurate emulation of PPU registers write conflicts in CGB double speed mode
- Correct emulation of reading
SVBK, fixes Flyeyes (unlicensed game) - Wired Switch Controllers now get automatic button mappings in the Cocoa frontend
- Fixed a bug where GBS files were starting with a wrong value in the
IEregister, fixes several GBS files - Emulation of the OAM corruption glitch triggered by the
jrinstruction, as well ashaltandstopmodes - Correct read emulation of the
BANKregister while still in the boot ROM - Fixed a bug where accurate RTC emulation halted while SameBoy wasn't running
- Accurate emulation of many sweep-related glitches, including revision differences
- Fixed a bug where
HDMA5was not correctly updated when disabling HBlank HDMA - Correct, revision-accurate emulation of reading from VRAM in the last cycle of Mode 3
- Channel 3 is now correctly mixed when emulating a GBA
Bug Fixes
- The "Step" icon in the Cocoa debugger was broken on non-Retina displays
- Fixed a bug where certain temperature tint settings would tint too much
- Banked breakpoints no longer trigger while executing the boot ROM
- Fixed camera emulation using the wrong aspect ratio on some Macs
- Fixed a bug that caused artifacts on the right and bottom edges of the Game Boy Camera
- Fixed a bug that allowed rewinding across ROM switches in the SDL frontend
- Fixed a bug that made rewinding try to rewind across model changes
- Fixed a bug that made save states created on Windows incompatible with other operating systems, and vice versa
- Several settings in both the SDL and Cocoa frontends had some unexpected defaults, which have been adjusted
- GameShark cheats were not imported correctly
- Fixed imported cheats not appearing in the Cocoa frontend
- Fixed the built-in MGB boot ROM being unexpectedly larger than it should be
- Prevented cases where the Cocoa debug console would remain open after closing a ROM
- Fixed a bug that caused the Libretro core to crash in link mode
- Fixed support for Xbox Wireless Controllers in the Cocoa frontend
- Some constants in the LCD and CRT filters were not updated when the shaders switched to linear RGB
- Fixed a bug where jump-to breakpoints disassembled the wrong address under certain scenarios
- Fixed an edge case where jump-to breakpoints did not work as expected, or took a slow code path
- Fixes a bug where certain macOS versions would fail to restore the previously opened windows due to a regression in Apple's code
- Fixed a bug that caused the VRAM viewer's toolbar to not appear on macOS Sonoma
- Fixed a bug where controllers did not always automatically connect or reconnect in the SDL frontend
Misc Internal Changes
- New APIs to explicitly reset the rewind buffer
- When building SameBoy in debug mode, assertions will now make sure functions are always called from a safe thread context
- Fixed an issue that caused the Cocoa preferences window to not open when building on some Macs
- Certain false positive warnings when building with GCC 9 are now avoided
- SameBoy can now be built as a library, allowing to disable certain features as required
- New APU APIs to allow detailed querying of its state
- SameBoy now correctly refers to its license as the Expat License
- Fixed an issue that prevented SameBoy to be built if the repository's path included a space
0.15.8
- Ajout de la possibilité d’utiliser la touche B (clavier ou contrôleur) pour quitter les menus dans l’interface SDL.
- Compatibilité arrière vers les états de sauvegarde depuis la version 0.14.3 et les émulateurs compatibles BESS.
- Correction d’un bug affichant des boutons déformés dans l’interface de débogage Cocoa sur macOS récent.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- The button mapped to B, on both the keyboard and controllers, can now be used to return from menus in the SDL frontend
Bug Fixes
- Fixed a bug that caused the new Cocoa debugger interface display glitched buttons on newer versions of macOS
0.15.7
- Ajout d’un mode de réinitialisation rapide équivalent à une réinitialisation par broche de la cartouche, conservant RAM et valeurs non initialisées.
- Support complet des Joy-Cons dans l’interface Cocoa : mappings clés sans configuration, rétroaction haptique, LEDs de joueur et contrôles de mouvement.
- Interface dédiée pour combiner/séparer les Joy-Cons et basculer leur orientation (horizontale/verticale).
- Meilleure intégration macOS : catégorisation comme application Game dans Launchpad.
- Correction d’un bug où la commande finish du débogueur ne fonctionnait pas correctement après manipulations de pile par le ROM.
- Correction d’un crash du volet des cheats lors de la saisie d’une adresse ou d’un code invalide (GameShark/GameGenie).
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- Debugger inputs in the Cocoa frontend now work if the emulator is paused rather than in debugger-stopped
- The Cocoa debugger was given an improved interface with better contrast, and traditional Continue/Step Over/Step In/Step Out buttons
- The debugger now has an
interruptcommand, in addition to the previously-available ^C key sequence - SameBoy is now properly categorized as a Game app in macOS's Launchpad
- The
lcdcommand now displays the background shifter and fetcher states - The Cocoa frontend can now perform a "quick reset", which is essentially equivalent to a reset via the cartridge reset pin, and retains RAM values, and other otherwise-uninitialized values
- The Cocoa cheats window is now less strict about forcing a user to type
$when typing an address - The
tickdebugger command now has an optionalkeepargument, which prevents resetting the tick count - Joy-Cons are now fully supported in the Cocoa frontend:
- This includes the usual pack of zero-configuration key-mappings, rumble support, player LEDs, and motion controls
- Additionally, a dedicated Joy-Con arrangement sheet lets you combine and separate Joy-Cons and switch their orientation from horizontal to vertical
Accuracy Improvements/Fixes
- Fixed a regression that made DMA restart timing inaccurate
- Fixed a regression that caused ROMs that trigger one of the pixel insertion glitches to display incorrectly (Release builds) or trigger an assertion (Debug builds)
- Fixed a different regression in a different pixel insertion glitch
Bug Fixes
- Fixed a bug where the debugger
finishcommand did not behave as expected in certain cases where the ROM manipulated the stack - Fixed a bug that caused the Cocoa cheat window to send debugger commands
- Fixed a regression that caused the Cocoa cheat window to crash when attempting to add an invalid GameShark or GameGenie code
- Fixed a bug that caused the Cocoa cheat window to crash while typing a cheat address on newer versions of macOS
Misc Internal Changes
- SameBoy (and SameBoot) can now be built with RGBDS 0.6.x; support for RGBDS 0.4.x has been dropped
- Fixed potential compilation warnings for incoming versions of Clang and GCC
- Added the
GB_quick_resetAPI
0.15.6
- Ajout du support de toutes les révisions CGB et du MGB dans le cœur libretro.
- Débugger amélioré avec une aide intégrée pour le commandement help.
- Possibilité de muter/démuter individuellement les 4 canaux audio dans les deux interfaces.
- Prise en charge du changement de cartouche à chaud dans les deux interfaces.
- Correction d’un bug de vitesse incorrecte après un changement de modèle dans le cœur libretro.
- Correction d’une régression mineure liée au DMA.
- Correction du champ "Go To" du Cocoa Memory Viewer, évitant les plantages.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- All CGB revisions, as well as MGB, are now available in the libretro core
- The debugger now guides users to use the
helpcommand - Both frontends can now selectively mute and unmute each of the 4 audio channels
- Both frontends now support cartridge hot swapping
Accuracy Improvements/Fixes
- Fixed a bug where the libretro core sometimes ran at an incorrect speed after switching models
- Fixed a minor DMA regression
Bug Fixes
- Fixed a bug where the Cocoa Memory Viewer "Go To" field did not work correctly and occasionally crashed
0.15.5
- Correction des déséquilibres dans les modes de correction de couleur affectant la désaturation.
- Prise en charge précise du comportement de la première trame pour Game Boy Color et Game Boy Advance, éliminant les clignotements blancs dans les jeux THQ.
- Amélioration de l'émulation du bug de répétition d'échantillonnage des canaux carrés, réduisant les pops audio dans LSDj et certains jeux avec effet vibrato.
- Correction des erreurs dans la version Cocoa (macOS) liées à des plantages du visualiseur mémoire et à des sauvegardes d'état incomplètes.
- Réinitialisation correcte de l'état MBC, permettant le démarrage de jeux après d'autres dans les frontends SDL, libretro et tiers.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- Both frontends now include links to the debugger documentation and to the GitHub Sponsors page
Accuracy Improvements/Fixes
- Fixed a bug where certain color correction modes were desaturating colors in an unbalanced manner
- Accurate emulation of the first-frame-behavior while emulating the Game Boy Color and Game Boy Advance; fixes white flashes while playing games developed by THQ
- More accurate emulation of the square channels sample repeat glitch, fixing certain audio pops in LSDj and various games while using a vibrato effect
Bug Fixes
- Fixed a bug introduced in the previous release that introduced several issues in the Cocoa version, including:
- The memory viewer crashing under some conditions
- Attempting to save state returned an error, despite saving being completed successfully
- Fixed a bug where MBC state was not properly reset, fixing bugs resulting in some games not booting correctly if they were loaded after certain other games in the SDL frontend, libretro, and other 3rd-party frontends
Misc Internal Changes
- New memory management APIs for better integration of SameBoy as a library
0.15.4
- Renommage des modes de correction de couleur "Emulate Hardware" et "Preserve Brightness" en "Modern – Balanced" et "Modern – Boost Contrast".
- Ajout d’un nouveau mode de correction de couleur "Modern – Accurate" pour une meilleure précision tout en gardant saturation et contraste modernes.
- Ajout de boutons d’aide dans la fenêtre de préférences Cocoa pour expliquer les modes de correction de couleur et de filtre passe-haut.
- Correction d’une erreur d’arrondi dans la correction de couleur.
- Correction d’un crash au lancement sur macOS ancien si une mise à jour était disponible.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
New/Improved Features
- The "Emulate Hardware" and "Preserve Brightness" color correction modes are now called "Modern – Balanced" and "Modern – Boost Contrast", respectively, to better represent them in the context other modes that came after their introduction
- A new "Modern – Accurate" color correction mode was added. This new mode preserves the modern saturation and contrast of "Modern – Balanced" but further improves on color balancing accuracy
- The Cocoa preferences window now includes help buttons that describe the different Color Correction and High-Pass Filter modes
- Major improvements to the performance of the Cocoa memory viewer
- The Anti-aliased Scale4x filter has been revised and improved
Accuracy Improvements/Fixes
- A color correction rounding error was fixed
Bug Fixes
- Fixed potential visual artifacts when using certain scaling filters on some combinations of resolutions and devices
- Fixed a bug that made SameBoy crash on launch on older versions of macOS if an update was available
- Fixed a bug where the Cocoa memory viewer temporarily showed wrong addresses
- The SDL will no longer get stuck (unless "Skip" is used) when trying to use certain joypads' D-pad to configure the directional keys
- Attempt to work around an X11 bug that caused file and directory selection dialogs to ignore mouse keys
Misc Internal Changes
- The Cocoa memory viewer no longer requires access to internal structures
0.15.3
- Améliorations des modes de correction de couleur pour une meilleure fidélité visuelle.
- Correction d’une condition de course pouvant faire planter l’outil Memory Viewer sans pause préalable.
- Suppression d’un avertissement erroné sur les sauvegardes non modifiables.
- Respect du paramètre joypads-in-background par la version SDL au démarrage.
This version is backwards compatible with save states from SameBoy 0.14.3 and newer, as well as save states from any BESS compliant emulator
Accuracy Improvements/Fixes
- Improvements to all color correction modes
Bug Fixes
- Fixed a race condition that could cause the Memory Viewer to crash if used without pausing the ROM first
- Fixed a bug that caused SameBoy to incorrectly warn about saves being unwritable
- Fixed a bug that caused SameBoy on Windows to not warn about saves being unwritable
- Fixed a bug that caused the SDL port to not respect the joypads-in-background setting at startup
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.