Game Boy Test Roms

Have a Game Boy emulator you want to test for accuracy? This collection of compiled Game Boy test roms might help. It includes (in alphabetical order):

• AGE test roms
  ^{by me}
• Blargg's test roms
  ^{by Shay Green (a.k.a. Blargg)}
• Bully, Scribbltests and Strikethrough
  ^{by Hacktix}
• cgb-acid-hell, cgb-acid2, dmg-acid2 and Mealybug Tearoom Tests
  ^{by Matt Currie}
• Gambatte test suite (as the original Gambatte repository is not public anymore, we use pokemon-speedrunning/gambatte-core instead)
  ^{by sinamas}
• GBMicrotest
  ^{by aappleby}
• MBC3 Tester
  ^{by Eric Kirschenmann}
• Mooneye Test Suite
  ^{by Joonas Javanainen}
• Mooneye Test Suite (wilbertpol)
  ^{by Joonas Javanainen and wilbertpol}
• (parts of) little-things-gb
  ^{by Damian Yerrick}
• rtc3test
  ^{by ax6}
• SameSuite
  ^{by Lior Halphon}
• TurtleTests
  ^{by Brian Jia}

Running test suites

For each test rom we have to consider:

• Game Boy devices & SoC revisions: What device & SoC revision is a test compatible to? This is quite important as some tests will not run on all devices. See the Mooneye Test Suite's readme for a list of devices and SoC revisions.
• Exit Condition: When is a test finished?
• Test Success/Failure: How do we identify test success or failure?

Details on this can be found in a separate readme for each test suite:

• AGE test roms (located at <release-zip>/age-test-roms/)
• Blargg's test roms (located at <release-zip>/blargg/)
• Bully (located at <release-zip>/bully/)
• cgb-acid-hell (located at <release-zip>/cgb-acid-hell/)
• cgb-acid2 (located at <release-zip>/cgb-acid2/)
• dmg-acid2 (located at <release-zip>/dmg-acid2/)
• Gambatte test suite (located at <release-zip>/gambatte/)
• GBMicrotest (located at <release-zip>/gbmicrotest/)
• MBC3 Tester (located at <release-zip>/mbc3-tester/)
• Mealybug Tearoom Tests (located at <release-zip>/mealybug-tearoom-tests/)
• Mooneye Test Suite (located at <release-zip>/mooneye-test-suite/)
• Mooneye Test Suite (wilbertpol) (located at <release-zip>/mooneye-test-suite-wilbertpol/)
• (parts of) little-things-gb (located at <release-zip>/little-things-gb/)
• rtc3test (located at <release-zip>/rtc3test/)
• SameSuite (located at <release-zip>/same-suite/)
• Scribbltests (located at <release-zip>/scribbltests/)
• Strikethrough (located at <release-zip>/strikethrough/)
• TurtleTests (located at <release-zip>/turtle-tests/)

Versioning

All noteworthy adjustments can be found in the changelog.

Note that version numbers are NOT based on semantic versioning as I am not capable of determining what update to any included test suite is actually a breaking change. Instead, major version numbers are increased with every addition of new test suites and minor version numbers are increased with any update to already included test suites.

Readme by release version:

• Readme v7.0
• Readme v6.0
• Readme v5.2
• Readme v5.1
• Readme v5.0
• Readme v4.0
• Readme v3.2
• Readme v3.1
• Readme v3.0
• Readme v2.0
• Readme v1.1
• Readme v1.0