game-boy-test-roms
A collection of different test suites for your Game Boy emulator
c-spgit clone https://github.com/c-sp/game-boy-test-roms.gitc-sp/game-boy-test-roms
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:
more like this