Skip to content

Compatibility

DeLFuS77 edited this page Nov 11, 2026 · 3 revisions

NXPress writes the NSZ and XCZ format of nsz, the one installers take. A file compressed with NXPress is decompressed by nsz, and the other way round.

File DBI Tinfoil Awoo CyberFoil Sphaira Emulators that read NSZ
NSP, XCI ✓ ✓ ✓ ✓ ✓ ✓
Solid NSZ (the default) ✓ ✓ ✓ ✓ ✓ Decompressed first
NSZ in blocks (-B) ✓ ✓ ✗ ✓ ✓ ✓
XCZ (always in blocks) ✓ ✓ ✗ ✓ ✓ ✓
NSZ with the extra compression (NCZSECT2, NCZSECT3) ✗ ✗ ✗ ✗ ✗ ✗

Tested with DBI. For an installer or emulator that only takes NSP or XCI, Decompress gives back the original, byte for byte. The same goes for a file written with the experimental extra compression, which only NXPress reads for now: decompress it before installing it.

Details tells what each file works with, and so does nxpress -i file on the command line.

SuperNSP

Files with several titles (a game with its updates and DLC) compress like any other. Combine makes them and Split turns them back into one file per title, byte for byte.

FAT32

A FAT32 microSD does not take files over 4 GiB. FAT32 splits a file into a folder of parts with the archive bit, which is read as one file, and joins such a folder, or parts named name.ns0, name.ns1…, back into one file. On Windows NXPress sets the archive bit; on other systems it is set with Hekate (Tools, Archive bit).

Optimized for install

A game optimized for install installs with NXDock or DBI, with sigpatches and firmware 12.0.0 or newer; official updates are not installed over it. Tested with DBI.

Clone this wiki locally