NdsForge.Audio.Wav 1.1.0

<p align="center"> <img src="https://raw.githubusercontent.com/JuliusJacobsohn/NdsForge.NET/main/assets/branding/ndsforge-wordmark.svg" alt="NdsForge: a dual-screen mark joined by a forge spark" width="720"> </p>

NdsForge.NET

Get NdsForge on NuGet · Browse the API documentation →

Getting started · Formats and safety · Nitro codecs · Nitro graphics · WAV audio · CLI reference · Corpus testing

NdsForge is a pure C# library for inspecting, validating, extracting, editing, comparing, and building Nintendo DS and DSi software images. Its object-oriented API supports path, stream, and in-memory workflows without shelling out to native tools.

Quick start

Install the library:

dotnet add package NdsForge

Install NdsForge.Nitro separately when an application needs reusable Nitro compression, container, or raw audio sample codecs without the ROM-image model:

dotnet add package NdsForge.Nitro

Install NdsForge.Graphics for dependency-light native indexed graphics, palettes, tiles, maps, and sprites. Host raster codecs remain separate adapters:

dotnet add package NdsForge.Graphics

Install NdsForge.Audio.Wav for bounded PCM WAV import/export, including native wave and stream loop conversion:

dotnet add package NdsForge.Audio.Wav

using NdsForge;

await using NdsImage image = await NdsImage.OpenAsync("game.nds");

Console.WriteLine($"{image.Header.Title} [{image.Header.GameCode}]");
Console.WriteLine($"{image.FileSystem.Files.Count} NitroFS files");

NdsValidationResult validation = image.Validate();
foreach (NdsDiagnostic diagnostic in validation.Diagnostics)
{
    Console.WriteLine($"{diagnostic.Severity}: {diagnostic.Code}: {diagnostic.Message}");
}

Parsing creates a navigable image model without modifying the source. Validation is explicit and reports structured findings instead of printing tool-specific text.

Highlights

• Typed DS, DSi-enhanced, and DSi-exclusive headers
• NitroFS directories, files, IDs, allocations, overlays, programs, banners, and SDK footers
• Bounded parsing and structured integrity diagnostics for untrusted images
• Safe selective extraction with traversal, collision, and reparse-point defenses
• Preservation-oriented edits with reviewable plans and atomic path writes
• Deterministic DS and DSi image construction from binary or supported ELF inputs
• Stable JSON manifests and semantic image comparison
• Caller-supplied KEY1, DSi digest, HMAC, modcrypt, and RSA operations
• Verified classic-DS per-overlay Download Play HMAC parsing, validation, replacement, and BLZ-aware repair
• An optional Ndstool1503 build profile for verified interoperability cases
• A dependency-free NdsForge.Nitro companion package for BLZ, BIOS compression, archives, messages, and other reusable Nitro formats
• An optional NdsForge.Graphics feature package for native indexed graphics, sprites, animations, and bitmap fonts without host image-codec dependencies
• An optional NdsForge.Audio.Wav adapter for PCM WAV interchange with native SWAV and STRM audio, without resampling or playback
• A cross-platform ndsforge .NET command-line tool over the same library

Edit an image

using NdsImage source = NdsImage.Open("game.nds");
NdsImageEditor edit = source.Edit();

edit.Header.Title = "MY MOD";
edit.ReplaceFile("/data/config.bin", File.ReadAllBytes("config.bin"));
edit.RepairHeaderCrc().RepairBannerCrcs();

NdsSaveResult result = await edit.SaveAsync(
    "mod.nds",
    new NdsWriteOptions { VerifyOutput = true });

An unchanged preservation edit is byte-identical. Structural file-system changes use NdsImageBuilder.FromImageAsync, keeping local patching and full rebuilding as separate, explicit workflows.

Command line

dotnet tool install --global NdsForge.Cli

ndsforge inspect game.nds
ndsforge validate game.nds
ndsforge list game.nds --long
ndsforge extract game.nds workspace
ndsforge manifest game.nds game.manifest.json
ndsforge diff game.nds rebuilt.nds

See the CLI reference for commands, options, and exit codes.

Compatibility and scope

NdsForge targets .NET 10. The core image and Nitro packages have no runtime NuGet dependencies; graphics and the WAV adapter each depend only on NdsForge.Nitro. The project handles Nintendo DS image/container structures; it is not an emulator, disassembler, save editor, or game-specific archive library. PNG/GIF authoring and proprietary game compression belong in separate adapters.

No ROMs, firmware, keys, certificates, or proprietary logo data are included. Cryptographic operations require caller-owned key material. Some authenticity checks cannot be completed from public image data alone, and validation distinguishes missing trust inputs from invalid content.

The compatibility suite uses synthetic fixtures and hash-bound expectations for legally dumped private images. Where an ndstool comparison is meaningful and deterministic, NdsForge records byte-level or semantic parity. Read formats, compatibility, and safety before handling unknown images or performing authenticated DSi builds.

Contributions should follow CONTRIBUTING.md, security reports follow SECURITY.md, and releases follow RELEASING.md. Licensed under the MIT License.

NdsForge.NET is maintained by Julius Jacobsohn. It is not affiliated with or endorsed by Nintendo, devkitPro, or the maintainers of ndstool.