|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/v20191109-155214_9e285a3 Commit 9e285a3 (2019/11/09) 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
 +
* Make sure your games are SRAM patched if needed, this is most likely only the case for FLASH1M_V103 (use [http://www.no-intro.org/gbadat/tools/gbata7a-en.zip gbata])
 +
* 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.(*)
+
== BIOS Checksums ==
 +
The BIOS used should have the following checksums (checking one should be enough):
 +
* CRC32: <code>81977335</code>
 +
* MD5: <code>a860e8c0b6d573d191e4ec7db1b1e4f6</code>
 +
* SHA1: <code>300c20df6731a33952ded8c436f7f186d25d3492</code>
 +
* SHA256: <code>fd2547724b505f487e6dcb29ec2ecff3af35a841a77ab2e85fd87350abd36570</code>
   −
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)
+
You can check the MD5 with [http://www.winmd5.com/ WinMD5Free] for example.
 
+
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.
+
== Work in Progress ==
+
- Saving on SD card '''Although it is tested, there is no guarantee that it will work fine in all cases,
+
so use it at your own risk. A backup of your sd is recommend!'''
+
 
+
== Not implemented yet ==
+
- '''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 build 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 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].
 
!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.
    
== Retail games ==
 
== Retail games ==