imclab / nds4ios

Port of the Nintendo DS emulator, nds4droid to iOS.

nds4ios - iOS 5 ~ 7

This is not finished software. Do not open issues complaining about games being slow, we know about it already.

PLEASE DO NOT DISTRIBUTE THIS BY CODE SIGNING IT, UPLOADING, THEN TELLING OTHERS TO DOWNLOAD IT FROM YOU. WE PROVIDE AN OFFICIAL WAY TO DISTRIBUTE ALREADY. THIS IS A FAIR WARNING.

nds4ios is a port of nds4droid to iOS, which is based on DeSmuME.

http://nds4ios.angelxwind.net/

DeSmuME

nds4droid

We all work hard to make this into software that users will enjoy and love. If you enjoy this software, please consider making a donation to help us create and provide better things.

Install Instructions

Option 1: Download it from aXwNET

If you're jailbroken: http://nds4ios.angelxwind.net/?page/downloads#jailbroken

If you're NOT jailbroken: http://nds4ios.angelxwind.net/?page/downloads#notjailbroken

Option 2: Compile it yourself

IMPORTANT: Make sure your working directory is devoid of spaces. Otherwise, bad things will happen.

1. Open a Terminal instance and go to your working directory.

2. Do git clone https://github.com/InfiniDev/nds4ios.git

3. then Navigate to the "nds4ios" folder in your working directory.

4. Open "nds4ios.xcodeproj", connect your device, select it on Xcode and click the "Run" button (or Command + R). Don't build it for the iOS Simulator. IMPORTANT: Make sure you change your running scheme to Release first. Otherwise you will get errors on compile!

Option 2a

1. Alternatively, run xcodebuild -configuration Release from Terminal and then copy the resulting *.app bundle to your /Applications directory on your device.

How To Load ROMs

Since this apparently needs explaining

Option 1 (Preferred Option)

1. In nds4ios, tap on the button in the upper right hand corner.
2. Download a ROM package of a ROM that you own the actual game cartridge for from a site such as CoolROM. It will come in a zip file. You do not have to have any sort of download manager for this, Safari will download zip files.
3. Tap the "Open in..." button in the top left hand corner, and select nds4ios.
4. nds4ios will automatically unzip the file, delete the readme, and refresh itself. Your ROM should show up in the list. Magic!

Option 2

1. Plug your device into your computer and launch iTunes.
2. Go to your iDevice's info page, then the apps tab.
3. drag and drop .nds files that you have (preferably ones you legally own the actual game cartridge for) into the iTunes file sharing box for nds4ios.
4. Kill nds4ios from the app switcher if it's backgrounded, and launch it again to see changes.

Option 3

1. If you're jailbroken, grab one of the many download tweaks available for Mobile Safari or Chrome for iOS, or grab one of the many web browsers available with download managers built in, such as Cobium (This is totally not a shameless plug).
2. With the new browser or tweak, download a rom, preferably one you own the actual cartridge for.
3. Using iFile or similar too, move the .nds file to the nds4ios directory, into the documents folder.
4. Kill nds4ios from the app switcher if it's backgrounded, and launch it again to see changes.

To-do

We'll get to these, really!

• JIT/Dynarec (very hard to achieve this using the clang compiler, in progress)
• OpenGL ES rendering
• Fix loading game saves on some games
• Ability to set the folder the rom chooser reads from
• Native iPad UI
• Add more localizations
• Much more.

Contributors

We stand on the shoulders of these people.

• The DeSmuME developers
• Jeffrey Quesnelle (jeffq), the developer of nds4droid
• rock88
• Karen Tsai (angelXwind)
• Brian Tung (inb4ohnoes)
• Jesús A. Álvarez (maczydeco)
• W.MS
• Riley Testut (rileytestut)
• David Chavez (dchavezlive)
• Michael Zhang (Malvix_)