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