Command line

With arguments, NXPress is a command line that takes the options of nsz, so it can take its place in scripts and in tools that call nsz. nxpress --help lists them all.

Examples

nxpress -C game.nsp                 compress to game.nsz
nxpress -C -l 19 -t 8 -o out games  compress every NSP and XCI of a folder at level 19 into out
nxpress -C --extra game.nsp         compress with the experimental extra compression, NXPress only
nxpress -D game.nsz                 decompress to game.nsp (an XCZ to an XCI)
nxpress -V game.nsz                 check a file
nxpress -V --verify-level signature games   check only the signature of every NCA, in seconds
nxpress -V --dat switch.dat games   tell which files are dumps a DAT (No-Intro) lists
nxpress --pack-games games          a SuperNSP per game of a folder
nxpress --split super.nsp           a SuperNSP into one file per title
nxpress --recompress -B game.nsz    write an NSZ again in blocks (or -S, solid), no NSP in between
nxpress --trim game.xci update.nsp  take away the padding of an XCI and the delta fragments of an update
nxpress --fat32 game.nsp            a file over 4 GB to a folder of parts (and back)
nxpress --rename "{name} [{id}][v{version}]" games   rename files by what they hold
nxpress -C --watch -o out inbox     compress every new file copied into inbox, until Ctrl+C

The options of nsz

Option	What it does
-C, -D	Compress or decompress
-V, -Q	Check the files; with -C or -D it is always done
-l N	Level, 1 to 19 (18 by default)
-B, -S	In blocks, or solid (the default)
-t N, -m N	Threads per file and files at once
-o [DIR]	Folder of the new files (by default, next to each file)
-w	Replace a file that is already there
--rm-source	Delete each original once its new file is checked
-i	The titles of a file, how it is stored and what it works with
--keys PATH	The prod.keys or keys.txt, or a folder holding one
--minimal-output, --machine-readable	The output on one line, or one JSON object per line, as nsz does

The options of nsz --long, --keep, --fix-padding, --alwaysParseCnmt, --rm-old-version, --bs and --depth are accepted and have no effect; NXPress says so once. As nsz does, it takes only the files of the folders given; --recursive looks into their folders too.

The options of NXPress

Option	What it does
--verify-level L	What -V checks: hash (the default; full, its name before 1.4.0, still works), signature or both. A file whose NCA are not signed by Nintendo while nothing is damaged is told MODIFIED, not FAILED, and does not count as failed
--no-cache	With -V, check again the files already checked too
--dat FILE	With -V, tell whether each file is a dump the DAT lists
--low-priority	Work at low priority, so the computer stays responsive
--extra, --sparse, --archive	The experimental extra compression, which only NXPress reads: games in sparse storage (NCZSECT2) and the LZ4 blocks of Nintendo (NCZSECT3), or one half each
--recursive	Take the files in the folders inside the folders given too
--watch	Keep looking at the folders given and work on each new file
--estimate, --levels	The size and the time a compression would give, also at several levels
--measure	Try threads and files at once, and tell the fastest for -t and -m
--convert	XCI and XCZ to NSP and NSZ
--recompress	Write an NSZ or XCZ again, with no keys and no NSP in between
--trim	Take away the padding of XCI files and the delta fragments of updates
--fat32	Split for FAT32, or join the parts back
--rename TEMPLATE, --keep-named	Rename by what the files hold, leaving the ones that have their title ID already
--split	A SuperNSP into one file per title
--pack FILE, --pack-one, --pack-games, --pack-name T	Combine into one file with everything, or into a SuperNSP per game, named by a template. Given a folder of one game, or of games each in a folder of its own, each pack goes next to its folder, not inside it (see Combine)
--optimize	Experimental: each game given with its newest update into one NSP (an NSZ with -C) that takes the least room installed. Named by --pack-name (default {name} [{id}][v{version}] (optimized)). It does not go with --rm-source, --watch or --extra (see Compression)

The fields of the templates are in Tour of the window › Rename.