Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Tool:ndstool

From ReverseEngineering.wiki
Tool
On this wiki Facts · Code · Notes · Topics

Command-line tool to extract, rebuild and inspect Nintendo DS ROMs (.nds): header, ARM9/ARM7 binaries, overlays, NitroFS tree and banner. Its source is a precise description of the ROM header.

Overview

ndstool (devkitPro fork, GPL-2.0) reads and writes Format:Nintendo DS ROM image (NDS). Source files worth reading: source/header.h (the full DS and DSi header, packed structs), banner.h (banner layout and version sizes), overlay.h (32-byte overlay entry, file names overlay_%04u.bin), ndscreate.cpp (how FNT/FAT/secure area are written, root directory id 0xF000), crc.cpp, encryption.cpp (secure area handling, public algorithm structure only).

Common uses: -i rom.nds to dump header fields, -x to extract, -c to rebuild.

Code & repositories

  • https://github.com/devkitPro/ndstool @ 76e8b681bb225d945a48852821e03114e6c7ce1c · license: GPL-3.0
    ndstool: source/header.h (ROM header), banner.h, overlay.h, ndscreate.cpp (FNT/FAT writing).
    Tested on: source read, not run: source read · checked 2026-10-18; last activity 2024-11-11