tau5 / noods

A (hopefully!) speedy NDS emulator

NooDS

A (hopefully!) speedy NDS emulator.

Overview

The goal of NooDS is to be a fast and portable Nintendo DS emulator. It's not quite there speed-wise, but it does offer most other features that you might expect from a DS emulator. It even supports GBA backwards compatability! I'm doing this for fun and as a learning experience, and also because I'm a huge fan of the DS. It may not be a worthy competitor for the other DS emulators just yet, but I believe that I can get it there someday. If not, that's fine too; like I said, I'm just having fun!

Downloads

NooDS is available for Linux, macOS, Windows, Switch, Vita, and Android. Automatic builds are provided via GitHub Actions; you can download them from the releases page.

Usage

NooDS doesn't provide high-level emulation of the BIOS yet, so you'll need to provide BIOS and firmware files dumped from your physical DS. The file paths can be configured in the settings. It also currently lacks automatic save type detection for DS games. If you load a new game and saving doesn't work, you'll have to manually change the save type. This information can be difficult to find, so it's easier if you have working save files already present.

Compiling for Linux or macOS

To compile on Linux or macOS, you'll need to install wxWidgets and PortAudio using your favourite package manager. You can use Homebrew on macOS, since there is no package manager provided by default. The command will look something like apt install libwxgtk3.0-dev portaudio19-dev (Ubuntu) or brew install wxmac portaudio (macOS). After that, you can simply run make in the project root directory to compile.

Compiling for Windows

To compile on Windows, you'll need to install MSYS2. Once you have that set up and running, you can install all of the packages you'll need by running pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-wxWidgets mingw-w64-x86_64-portaudio mingw-w64-x86_64-jbigkit make. It might also be a good idea to run pacman -Syu to ensure everything is up to date. After that, you can simply run make in the project root directory to compile.

Compiling for Switch

To compile for the Switch, you'll need to install devkitPro and the switch-dev package. You can then run make -f Makefile.switch in the project root directory to compile.

Compiling for Vita

To compile for the Vita, you'll need to install Vita SDK. You can then run make -f Makefile.vita in the project root directory to compile.

Compiling for Android

To compile for Android, the easiest way would be to use Android Studio. You'll also need to install the Android NDK for compiling native code. Alternatively, you can use the command line tools; use sdkmanager to install build-tools, cmake, ndk-bundle, platform-tools, and platforms;android-29, and set an ANDROID_SDK_ROOT environment variable to the folder containing cmdline-tools. You should then be able to compile by running ./gradlew assembleRelease in the project root directory.

References

• GBATEK by Martin Korth - This is where most of my information came from
• GBATEK Addendum by Arisotura - GBATEK isn't perfect, so some information came from here as well
• Blog Posts 1, 2, 3, and 4 by Arisotura - Great resources that detail the 3D GPU's lesser-known quirks
• ARM Opcode Map by Imran Nazar - Used to create the interpreter lookup table
• Hardware tests by me - When there's something that I can't find or want to verify, I write tests for it myself!

Other Links

• Hydra's Lair - you can read about my progress here!
• NooDS Discord - here we can chat and do other fun stuff!