+
 +
 
{{InfoBox
 
{{InfoBox
 
  |title=GBARunner2
 
  |title=GBARunner2
 
  |data4 = [https://github.com/Gericom/GBARunner2 GitHub]
 
  |data4 = [https://github.com/Gericom/GBARunner2 GitHub]
 
  |label5 = Latest version
 
  |label5 = Latest version
  |data5 = [https://gbatemp.net/attachments/2019-06-14-8e4d520-zip.169862// Commit 8e4d520 (2019/06/14) (sd_save branch)(if arm9 doesn´t work, try arm7.)]
+
  |data5 = [https://github.com/Gericom/GBARunner2/releases/tag/v20200216-165624_c417fd0 Commit c417fd0 (2020/02/16) build]
 
  |label6 = Discussion thread
 
  |label6 = Discussion thread
 
  |data6 = [https://gbatemp.net/threads/gbarunner2.451970/ GBATemp.net]  
 
  |data6 = [https://gbatemp.net/threads/gbarunner2.451970/ GBATemp.net]  
 
}}
 
}}
   −
'''GBARunner2''' is a GBA hypervisor for DS (like Nintendont for GC on Wii).
+
'''GBARunner2''' is a hypervisor that runs GBA games on DS/DSi/3DS in DS mode, basically like Nintendont does for running Gamecube games on Wii.
    
= Usage =
 
= Usage =
 +
* Place a GBA bios on your sd card. Either /bios.bin, /gba/bios.bin, or /_gba/bios.bin will work.
 +
** '''Note:''' Do not use Normmatt's open-source GBA BIOS. It won't work, as many patches are applied at fixed addresses. The right checksums are listed below.
 +
* If you have a gba folder on the root of your sd, this folder will be opened by default
 +
* Do '''NOT''' use SRAM patches unless stated on the wiki. They cause problems with the internal patching of GBARunner2 and may actually break saving.)
 +
* If you are using GBARunner2 with TWiLightMenu on a DSi or 3DS with the SD card, make sure you use the dldi on ARM7 build
   −
1. Make sure your SD card is fat32 formatted.
+
If you want to use existing save files, they should have the same name as the gba file but instead of .gba they should be .sav (so the save for mygame.gba is mygame.sav).
 
+
2. Put a GBA bios as bios.bin in the "gba" folder in the root of your sd card.(*)
+
 
+
3. Put GBARunner2.nds on your sd card. If you are running TWiLight Menu++/DSiMenu++/SRLoader, GBARunner2.nds should be in the "_nds" folder (should be already)
+
 
+
4. '''Some Games need to be sram patched if the game didn't already use sram for saving''' [http://www.no-intro.org/tools.htm GBATA]. This prevents some Error Messages.
+
 
+
5. By default, GBARunner2 will look for a "gba" directory on the root of your sdcard, otherwise it will open the root of your sdcard.
+
 
+
6. Run gbarunner2.nds. If you are running TWiLight Menu++/DSiMenu++/SRLoader, touch the GBA icon (DSi and 3DS themes), select the 3rd icon (R4 theme), or select GBARunner2 in the menu (Acekard theme).
+
 
+
With Commit a61e70e Version it is possible to load your save files. They should have the same name as the gba file but instead of .gba they should be .sav. The games need to be sram patched to recognise the sav files.
+
   −
(*) Do not use Normmatt's open-source GBA BIOS, as some patches are applied to the BIOS at hardcoded addresses. The MD5 of the BIOS you must use is A860E8C0B6D573D191E4EC7DB1B1E4F6. Use [http://www.winmd5.com/ WinMD5Free] to check the MD5.
+
== BIOS Checksums ==
== Work in Progress ==
+
The BIOS used should have the following checksums (checking one should be enough):
- Saving on SD card '''Although it is tested, there is no guarantee that it will work fine in all cases,
+
* CRC32: <code>81977335</code>
so use it at your own risk. A backup of your sd is recommend!'''
+
* MD5: <code>a860e8c0b6d573d191e4ec7db1b1e4f6</code>
 +
* SHA1: <code>300c20df6731a33952ded8c436f7f186d25d3492</code>
 +
* SHA256: <code>fd2547724b505f487e6dcb29ec2ecff3af35a841a77ab2e85fd87350abd36570</code>
   −
== Not implemented yet ==
+
You can check the MD5 with [http://www.winmd5.com/ WinMD5Free] for example.
- '''GUI is now available in the latest build!'''
+
    
= Compiling the latest version =
 
= Compiling the latest version =
 
3. Run make in the root.
 
3. Run make in the root.
   −
= Downloads =  
+
= Downloads =
 +
New commits are now automatically built and can be downloaded on the [https://github.com/Gericom/GBARunner2/releases github release page].
 +
 
 +
Download link for gbarunner2 compatible cover art: https://mega.nz/#!Q8dnHALK!kA4UuEpqo7JQwScxLiorZ_qj4lWBsBr7B6Sb_BgAzsw
 +
 
 +
* '''Commit 371815e (2019/09/11) latest in ROM3M branch needed to play Pokemon Emerald and others on DS.''' https://github.com/Gericom/GBARunner2/releases/tag/v20190911-201047_371815e '''
 +
 
 +
* Commit 5abecad (2019/07/05), (Fixes the contra title screen, partially the advance wars intro, Madden NFL Note that bitmap bg transforms are currently not supported) posted [https://github.com/Gericom/GBARunner2/releases/tag/commit_5b06bb4bd12d8fe12574b0564e0ce0fb7fb02760 here].
 +
* Commit 5b06bb4 (2019/07/03), (Changed dma behavior on invalid addresses again, still not completely) posted [https://github.com/Gericom/GBARunner2/releases/tag/commit_5b06bb4bd12d8fe12574b0564e0ce0fb7fb02760 here].
 +
* Commit 03f8646 (2019/07/01), (Optimized the abort handler a little more) posted [https://github.com/Gericom/GBARunner2/releases/tag/commit_03f86467974caba8ae6c4463b5b5d42ad49ab826 here].
 +
* Commit e592198 (2019/07/01), (Set up CI with Azure Pipelines) posted [https://github.com/Gericom/GBARunner2/releases/tag/commit_e59219891e31d3d30b248b4c6a8bb9289b4d4b80 here].
 +
* [https://gbatemp.net/attachments/2019-06-30-897403a-zip.171803// Commit 897403a (2019/06/30) (master branch)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-82#post-8698213 here].
 +
* [https://gbatemp.net/attachments/gbarunner2-zip.171425// Commit 09c3fb7 (2019/06/26) (feature/newabort2 branch) (experimental arm7dldi_wramicache Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-80#post-8692494 here].
 +
* [https://gbatemp.net/attachments/gbarunner2-zip.171378// Commit 6084943 (2019/06/26) (feature/newabort2 branch) (experimental arm7dldi_wramicache Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-80#post-8691975 here].
 
* [https://gbatemp.net/attachments/2019-06-14-8e4d520-zip.169862// Commit 8e4d520 (2019/06/14) (sd_save branch)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-77#post-8676640 here].
 
* [https://gbatemp.net/attachments/2019-06-14-8e4d520-zip.169862// Commit 8e4d520 (2019/06/14) (sd_save branch)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-77#post-8676640 here].
 
* [https://gbatemp.net/attachments/2019-06-10-8175479-zip.169640// Commit 8175479 (2019/06/10) (sd_save branch)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-74 here].
 
* [https://gbatemp.net/attachments/2019-06-10-8175479-zip.169640// Commit 8175479 (2019/06/10) (sd_save branch)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-74 here].
 
* [https://gbatemp.net/attachments/gb_audio-d5d99e7-02-04-2019-zip.162672// Commit d5d99e7 (2019/04/02) (gb audio branch, no saving!)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-67 here].
 
* [https://gbatemp.net/attachments/gb_audio-d5d99e7-02-04-2019-zip.162672// Commit d5d99e7 (2019/04/02) (gb audio branch, no saving!)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-67 here].
 
* [https://gbatemp.net/attachments/gbarunner2_arm9dldi_wramicache-nds-zip.148184// Commit 6522414 (2018/11/01) (arm9wramicache Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-57#post-8359865 here].
 
* [https://gbatemp.net/attachments/gbarunner2_arm9dldi_wramicache-nds-zip.148184// Commit 6522414 (2018/11/01) (arm9wramicache Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-57#post-8359865 here].
* [https://gbatemp.net/attachments/gbarunner2_arm9dldi-nds-zip.148183/ Commit 6522414 (2018/11/01) (arm9Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-57#post-8359865 here].
+
* [https://gbatemp.net/attachments/gbarunner2_arm9dldi-nds-zip.148183/ Commit 6522414 (2018/11/01) (arm9 Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-57#post-8359865 here].
 
* [https://gbatemp.net/attachments/gbarunner2_arm7dldi_wramicache-nds-zip.148182// Commit 6522414 (2018/11/01) (arm7wramicache Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-57#post-8359865 here].
 
* [https://gbatemp.net/attachments/gbarunner2_arm7dldi_wramicache-nds-zip.148182// Commit 6522414 (2018/11/01) (arm7wramicache Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-57#post-8359865 here].
 
* [https://gbatemp.net/attachments/gbarunner2_arm7dldi-nds-zip.148181/ Commit 6522414 (2018/11/01) (arm7 Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-57 here].
 
* [https://gbatemp.net/attachments/gbarunner2_arm7dldi-nds-zip.148181/ Commit 6522414 (2018/11/01) (arm7 Version)], posted [https://gbatemp.net/threads/gbarunner2.451970/page-57 here].
    
= Compatibility list =
 
= Compatibility list =
 +
 +
<big>'''[[GBARunner2/DSi_3DS_Compatibility_List|The DSi and 3DS have their own compatibility list! Click Here!]]'''</big>
    
{|width="25%" cellspacing="1" border="1px"
 
{|width="25%" cellspacing="1" border="1px"
 
!Legend
 
!Legend
 
|-
 
|-
|align="center" style="background:#4CAF50"|Very Playable - Full Speed. Very Good Audio. No GFX Glitches.
+
|align="center" style="background:#4CAF50"|Very Playable - Full Speed. Very Good Audio. No gfx glitches.
 
|-
 
|-
|align="center" style="background:#B4EEB4"|Playable - Full Speed. Very Good Audio with a little Noise/stuttering. A Few GFX Glitches.
+
|align="center" style="background:#B4EEB4"|Playable - Full Speed. Good Audio with a little Noise/stuttering. Few gfx glitches. Gameboy Sounds are missing.
 
|-
 
|-
|align="center" style="background:#FFEB3B"|Playable - Minor Performance issues. Gameboy Sounds missing.
+
|align="center" style="background:#FFEB3B"|Playable - Minor Performance issues. Gameboy Sounds are missing.
 
|-
 
|-
 
|align="center" style="background:#FFB142"|Working/Unplayable - Game is very slow/laggy/glitched up.
 
|align="center" style="background:#FFB142"|Working/Unplayable - Game is very slow/laggy/glitched up.
      −
* '''! A save error message (and sometimes other crashes too) means that your game must be sram patched (every game not using sram should be patched so check that before reporting) - check the Usage section for the appropriate tool !'''
+
* '''! A save error message (and sometimes other crashes too) means that your game must be sram patched - check the Usage section for the appropriate tool !'''
   −
* '''! Some games have Release Intro´s attached to themselve. Those Intros use a Code that is not supported yet. Try using the GBATA tool to remove the Intro to get the Game to work. Use an Emulator to see if a Game has a Rom Intro or not !'''
+
* '''! Some games have Release Intro´s attached to them. Those Intros use a Code that is not supported yet. Try using the GBATA tool to remove the Intro to get the Game to work. Use an Emulator to see if a Game has a Rom Intro or not ! Also check if the ROM is a verified good dump by No-Intro by comparing the hashes of your ROM (CRC32, MD5 etc.) with the ones found on [https://datomatic.no-intro.org/ DAT-o-MATIC]'''
       
== Retail games ==
 
== Retail games ==