Remote debugger for Nintendo DS games
Branch: master
Clone or download
pleonex Improve server connections in Unit Tests
Previously since in the TearDown it opened connections,
it could leave some open connections. It was also trying
to close twice the connections (TearDown and FixtureTearDown)
Latest commit 7c144f9 Sep 6, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
DeSmuMEmod Included desmume modifications files Dec 7, 2014
NitroDebugger.UnitTests
NitroDebugger Change license to MIT Sep 6, 2016
Plugins/IO_RegisterViewer Change license to MIT Sep 6, 2016
icon Change license to MIT Sep 6, 2016
.gitignore Clean gitignore Mar 15, 2015
.gitmodules Remove unnecessary libgame dependency Sep 6, 2016
.travis.yml 💚 Remove old dependency from CI Sep 6, 2016
LICENCE Change license to MIT Sep 6, 2016
NitroDebugger.sln Create a folder for plugins Mar 15, 2015
README.md Updated readme with compile instructions Dec 21, 2014

README.md

NitroDebugger Gitter

Build Status license progressed.io


Look into game secrets.

logo

NitroDebugger is a remote debugger for Nintendo DS games. It connects to DeSmuME emulator with the GDB Remote Stub Protocol.

Usage

To use NitroDebugger you need:

  • NitroDebugger: Compilation information below.
  • DeSmuME with GDB Stub: Compilation information below.
  • Nintendo DS game: I don't support piracy. Here there is a tutorial to create your own backups.

Compilation

It has been developed and tested with mono 3.10.0 in Fedora 20.

Linux

You need to install git using your package manager (ie apt-get, yum, pacman...) and the last stable mono version from here.

# Clone the repository
git clone https://github.com/pleonex/NitroDebugger
cd NitroDebugger

Now, you can either open the solution with MonoDevelop or compile from the terminal:

# Restore NuGet packages
wget http://nuget.org/nuget.exe
mono nuget.exe NitroDebugger.sln

# Compile
xbuild NitroDebugger.sln

# [Optional] Run test
# Install nunit-console from your package manager
nunit-console NitroDebugger.UnitTests/bin/Debug/NitroDebugger.UnitTests.dll

Windows

  1. Clone the repository with the GitHub client or download the zip.
  2. Download and install Xamarin Studio from here and open the solution. It should work with Visual Studio and SharpDevelop too.
  3. Compile!

DeSmuME with GDB Stub

You need to compile DeSmuME to activate the GDB Stub support. Once you have that version you must run it with the --arm9gdb argument:

desmume --arm9gdb=PORT_NUMBER PATH_TO_GAME.nds

Linux

svn checkout svn://svn.code.sf.net/p/desmume/code/trunk desmume
cd desmume
./autogen.sh
./configure --enable-gdb-stub
make
sudo make install

Windows

You need Visual Studio C++, it works with the Express edition too.

  1. Download the source code by clicking the Download Snapshot button from here
  2. Unzip it (you can use 7-zip)
  3. Copy src/windows/defaultconfig/userconfig.h to src/windows/userconfig/ and comment out the line #define GDB_STUB
  4. Open the solution file from src/windows/ with Visual Studio and compile