This version is not compatible with save states of older versions.

New/Improved Features

• A symbol file for IO-registers is now included
• The Cocoa GUI now handles errors and warnings in a more user friendly manner
• The debugger now includes an lcd command, that outputs information about the LCD controller and related registers
• Improved audio quality, especially on Windows, by adding supersampling support
• Upgraded the SDL port from SDL 1.2 to SDL 2.0
• The following features were added to the SDL port:
  • OpenGL renderer
  • Reset and pause shortcuts
  • Ability to mute and unmute the audio
  • Ability to switch model between CGB and DMG without restarting SameBoy
  • Ability to open ROMs with drag and drop
  • Resizing, with 3 different mode (Entire window, keep aspect, and integer ratio)
  • Help dialog, accessible by the Shift+? shortcut (macOS) or F1 (Other platforms)
• Improved input in the Cocoa debugger; supports command history (up/down) and reverse search (^R)

Accuracy Improvements/Fixes

• Much more accurate emulation of HDMA
• The effect of the DI opcode is no longer delayed
• SameBoy's CGB boot ROM no longer incorrectly changes the RAM bank
• Fixed a bug where HUC1 banks higher than 0x1F were not mapped correctly
• Fixed a bug where MBC5 would map the wrong bank if address 3XXX is written before 2XXX is
• The STOP instruction is now treated as a 2-byte opcode
• LCD timing was rewritten and is now much more accurate
• Corrected behavior of the HUC1 RAM enable switch
• Large ROMs use MBC3 if the header claims no MBC should be use, for better compatibility with unofficial ROMs
• Fixed a bug in the implementation of the STAT write bug
• The value of SCX now affects the LCD's mode 3 length
• More accurate FPS capping that tracks time correctly even when the LCD is off
• Window behavior rewritten and and is now much more accurate; fixes Donkey Kong '94
• Fixed a bug where sound is generate on the wave channel while it shouldn't be

The following games now pass the automatic testing:

Alfred's Adventure, Animorphs, Armada - FX Racers, Asterix - Search for Dogmatix, Bad Badtz-Maru Robo Battle, Barbie - Pet Rescue, Bear in the Big Blue House, Blue's Clues - Blue's Alphabet Book, Boarder Zone, Bob et Bobette - Les Dompteurs du Temps, Caesars Palace II, Captain Knick-Knack (Sachen), Daikaijuu Monogatari - The Miracle of the Zone II, Disney's Tarzan, Doug's Big Game, Dragon Tales - Dragon Wings, The Emperor's New Groove, Fort Boyard, Honkaku Yonin Uchi Mahjong - Mahjong Ou, Hoyle Casino, Kinniku Banzuke GB3 - Shinseiki Survival Retsuden!, Konami GB Collection Vol.2, Konami GB Collection Vol.4, LEGO Racers, Lemmings & Oh No! More Lemmings, Les Aventures De TinTin - Le Temple du Soleil, Matchbox - Emergency Patrol, Microsoft Entertainment Pack, Pia Carrot he Youkoso!! 2.2, Pocket Music (E), Pokemon Card GB (J), Puchi Carat, San Francisco Rush 2049, Scrabble, The Simpsons - Night of the Living Treehouse of Horror, Star Wars Episode I - Obi-Wan's Adventures, Supreme Snowboarding, Tintin in Tibet, Toki Tori, Tomb Raider - Curse of the Sword, Turok 3 - Shadow of Oblivion, VS Lemmings, World Destruction League - Thunder Tanks, Yu-Gi-Oh! Duel Monsters 4 - Saikyou Kettousha Senki

Bug Fixes

• The SBC instruction was incorrectly printed as "LBC" in the debugger
• The LDH instruction was not symbolicated
• Fixed a bug with saving and loading save states and battery states on Windows
• Fixed a bug where saving or loading save states sometimes worked incorrectly in the SDL port
• Fixed a bug where the VRAM window would now show correctly if the game is paused
• Fixed a bug where ^C in the Cocoa port would not move the focus to the console

Misc Internal Changes

• Major refinements to the API

Version 0.8

New/Improved Features

• The debugger now includes a ticks command, to allow tick counting
• The debugger now includes a palettes command, to allow dumping the palettes in CGB mode
• General optimizations
• Complete GameBoy Camera support in the Cocoa port, basic support in the SDL port
• Debugger syntax improved, commands now allow modifiers
  • print/eval can now have a format modifier (e.g. print/d)
  • examine can now have a byte count modifier (e.g. x/4)
• The debugger now includes a disassemble command
• Added a VRAM viewer to the Cocoa port
• GameBoy Printer emulation in the Cocoa port
• New icon for GBC files, following Nintendo's color-coding convention, fixed icon alignment for both GB and GBC icons
• Quick Look support in Cocoa: GB and GBC files now display in-game screenshots on their cartridge icon

Accuracy Improvements/Fixes

• The APU emulation was refactored, and is now faster and now longer dependent on the sampling rate
• LCDC's bit 0 is now properly emulated (Fixes: Krusty's Fun House)
• The HALT bug is now emulated
• The user is now prevented from pressing opposite keys at the same time (Fixes Pocket Bomberman)
• Fixed MBC2 RAM emulation
• Corrected emulation of the palette registers in CGB mode
• HUC1 is now partially emulated, sans the IR sensor
• Basic HUC3 support, only the MBC is emulated
• Implemented the STAT-write interrupt bug (Fixed: Road Rash and Zero no Densetsu; these games do not work on CGBs)
• Limited the LY=144 interrupt to DMG mode, as hinted by MooneyeGB's test ROMs

The following games now pass the automatic testing:

All-Star Baseball '99, Cave Noire, Daisenryaku, F-1 Race, Gameboy Camera, Hatris, Ironman, Konami Golf, Kwirk, Meitantei Conan, Nintendo World Cup, Pocket Bomberman (J), Puzzle Boy, SS Spinner, The Smurfs, Speedball 2, Tecmo Bowl, Teenage Mutant Ninja Turtles 2, Tsuri Sensei, Ultima, Ultra Golf, WordZap, Z - The Miracle of the Zone, Zerd no Densetsu

Bug Fixes

• Fixed a deadlock in the Hex Editor/Viewer when viewing APU data
• Fixed a crash when accessing MBC RAM on some ROMs that do not have MBC RAM
• Multiple watchpoints did not function correctly
• Improved the behavior and performance of the open dialog in Cocoa
• Fixed dereferencing a non-banked address in the debugger
• VRAM was not initialized
• Fixed an edge case where the Hex Editor/Viewer crashed
• Breakpoint and watchpoint conditions no longer trigger other watchpoints; fixed potential crashes
• Better handling of input in the Cocoa port when the system has a non-ASCII keyboard layout
• Minor fixes for the help debugger command

Misc Internal Changes

• Added rumble API, but it is not actually used by any of the GUIs
• Added serial API, but it is currently only used internally for the GameBoy Printer

Version 0.7

New/Improved Features

• The debugger now includes a backtrace command to show the stacktrace
• Cocoa port now includes a Hex Editor/Viewer
• The debugger help command was improved
• General improvements to debugger usability
• The SDL port now compiles on Windows (Binaries included)
• Mouse hiding in Cocoa is now only enabled during full screen
• The Cocoa port now remembers the mute setting
• SameBoy now issues a warning when loading a game that uses an unsupported cartridge
• Cocoa port now remembers previous breakpoints/watchpoints after reset
• Cocoa port now automatically shows the open if needed

Accuracy Improvements/Fixes

As of this version, SameBoy is regularly tested against 1405 DMG ROMs to make sure no accuracy regressions are made. The latest results are available here.

• OBP0/1 are now initialized to the correct value (Fixes Mooneye's DMG hardware registers test).
• A disconnected serial cable is now emulated. Fixes:
  • Baseball
  • Faceball 2000
  • Fighting Simulator
  • Godzilla
  • Hiryuu Gaiden
  • In Your Face
  • Lunar Lander
  • Pinball Party
  • Sneaky Snakes
  • Super R.C. Pro-Am
  • WWF Stars
  • Yoshi's Egg
• Correctly emulating unused OAM RAM in DMG mode
• DMG boot ROM now finishes with the original register values (Fixes Mooneye's DMG boot registers test)
• RTC clock latching is now emulated.
• Fixed APU issues where simultaneously running games could affect eachother
• Fixed APU issue that could break some games. Fixes:
  • Chiki Chiki Tengoku
  • Moguranya/Mole Mania
• Fixed MBC RAM not being properly reset. Old save data must be deleted for this fix to apply. Fixes:
  • Purikura Pocket 3
  • Probably affects many other games

Bug Fixes

• Boot ROMs were not trimmed correctly
• Fixes several bugs that caused the Cocoa port to freeze when using the reset command during debugging

Misc Internal Changes

• SameBoy can now be compiled with precompiled (non-SameBoy) boot ROMs
• SameBoy includes an automated game ROM tester

Version 0.6

New/Improved Features

• Conditional r/w/rw debugger watchpoints
• Added the "!=" operator to the debugger
• Redefined the debugger input and output syntax, being more consistent with RGBDS
• Debugger now reads .sym files (Tested with 3 popular formats). It shows symbols when possible, and allows using them in expressions
• Debugger data types can now be either 16-bit values, or 25-bit full addresses that include a bank identifier
• Debugger commands and expressions support full addresses as parameters. This allows, for example, breaking on an address on a specific ROM bank, or reading a value from a specific MBC RAM bank.
• Some debugger commands may now run without breaking the debugger. (Similar to LLDB or GDB's async mode)
• SDL port now supports save states
• Improved performance by about 6% by enabling link-time optimizations
• Reduced file size by stripping executables
• Several Cocoa-only UX improvements:
  • Prevented being paused "twice" (Both by the pause option and the debugger)
  • Optional proportional resizing
  • Proper fullscreen support
  • Mouse cursor is now hidden while running

Accuracy Improvements/Fixes

This version includes major accuracy improvements, which allow it to pass 54 tests out of mooneye-gb's 58 acceptance tests (2 of which fail due to not including the original boot ROM); more than any other emulator.

• Rewritten MBC support, with MBC1M support (Fixing some N-in-1 cartridges)
• Major accuracy improvements to OAM DMA.
• Corrected a lot of instruction memory-access timings
• Corrected some IO register masks
• Major accuracy improvements to timers (TIMA/DIV)

Bug Fixes

• Corrected operator priorities in the debugger
• Fixed a bug where a breakpoint might have been ignored
• Reduced CPU usage when running games with a real time clock
• Handling ^C and ^D more sanely in SDL port
• Fixed memory leak in Cocoa

Misc Internal Changes

• Added infrared API, but it is not actually used by any of the GUIs
• Fixed build system bugs that caused needless dep file generation, and made the Cocoa build fail sometimes if SDL is not installed

Version 0.5

This version is not compatible with save states of older versions.

New/Improved Features

• Updated save state format, should now be much more future compatible
• Save state compatibility between 32 and 64 bit versions of SameBoy
• Cocoa version is now using OpenGL 3
• HQ2x filter added (Cocoa only)
• A new, redesigned OmniScale filter; old filter is renamed to OmniScale Legacy (Cocoa only)
• Cocoa port now "remembers" the last window size
• Added boolean operators to the debugger
• Added conditional breakpoints

Accuracy Improvements/Fixes

• Better emulation of certain behaviors of the SCX register
• Fixed emulation of the STOP instruction
• Minor fix to the accuracy of the JOYPAD register
• Minor improvements to HDMA accuracy

Bug Fixes

• Improved concurrency in the Cocoa port
• Fixed a bug where an emulator window in the Cocoa port will freeze until resized
• Fixed incorrect disassembler outputs
• Fixed a potential crash when deleting a breakpoint

Misc Internal Changes

• Large code refactoring, getting ready to stabilize API

Version 0.4

This version is not compatible with save states of older versions.

New/Improved Features

• Cocoa port now includes several scaling algorithms, including a beta of the exclusive OmniScale algorithm
• SDL port now includes sound support
• SDL port now includes battery save support

Accuracy Improvements/Fixes

• APU emulation now includes stereo support
• Improved PCM registers emulation
• More accurate STAT interrupt emulation. This fixes Altered Space.

Bug Fixes

• The Cocoa port ignored some key presses if the user keyboard layout included non-ASCII characters
• Fixed a bug that could cause a crash when adding or removing a breakpoint

Version 0.3

New/Improved Features

• New debugger command: cartridge (alias: mbc) shows information about the cartridge and the current status of the MBC
• Experimental debugger command: sld (Short for Stack Leak Detection) behaves similarly to finish, but stops if a stack leak or stack overflow is detected
• The Cocoa port now allows configuring controls

Accuracy Improvements/Fixes

• ROM banks now wrap (Fixes game: Pocket Monster Adventures (Bootleg))
• Fixed incorrect DMA behavior, DMA might fail for specific source addresses (Fixes game: The Smurfs 3)
• Timer registers were counting too slow in CGB double speed mode
• Corrected read behavior of the HDMA5 register (Fixes game: A Bug's Life in CGB mode)
• Fixed a bug with the CGB boot ROM that prevented initialization of the wave RAM
• The CGB boot ROM now loads the DMG tilemap for specific games, just like the original ROM (Fixes game: X (intro animation))
• Fixed a bug where audio channel 3 was playing silently while it should have been muted.

Bug Fixes

• Debugger's finish command now behaves correctly when interrupts are involved
• Corrected the description for the breakpoint command
• Sameboy will not create save files for ROMs without cartridge RAM or RTC, even if they report having a battery, preventing 0-bytes save files

Version 0.2

New/Improved Features

• Support for multiple breakpoints
• Better debugger command style and error reporting; includes help command
• In the SDL port, ^C in the terminal will break the debugger instead of quitting SameBoy
• Cocoa port now saves preferences (Model and frame blending)
• It is not possible to toggle console output and debugging in the Cocoa port

Accuracy Improvements/Fixes

• Read/write masks corrected for several registers
• Corrected 144th OAM interrupt behavior
• LCD operation moved to advance_cycles, fixing some obscure timing issues (Fixes game: X / Ekkusu)
• More accurate emulation of the registers controlling DMG emulation on CGB
• Emulation of PCM_12 and PCM_34 in the SDL port

Bug Fixes

• Debugger's next command can now exit a function