nsz
4.6.1
Ein Kompressions-/Dekompresson -Skript (mit optionaler GUI), mit dem Benutzer dank des ZSTD -Komprimierungsalgorithmus dank des Nintendo -Schalters löst komprimieren/dekomprimieren können. Die komprimierte Datei kann direkt mit unterstützten NSW -Homebrew -Titelinstallateuren installiert werden.
Ein Schweizer Spiegel dieses Repositorys wird unter https://gitlab.nicobosshard.ch/nicoboss/nsz aufrechterhalten
Dies wird das neue Zuhause sein, falls Github jemals NSZ abnimmt. Bitte ein Lesezeichen.
Es gibt verschiedene Möglichkeiten, dieses Tool zu installieren. Sie können Details zur Installation für alle unten finden.
Sie benötigen eine HACTOOL -kompatible Schlüsseldatei in einem geeigneten Verzeichnis, um dieses Tool zu verwenden .
Die Schlüsseldatei muss als prod.keys -Datei in %USERPROFILE%/.switch/ (Windows)/ $HOME/.switch/ (UNIX) oder keys.txt im Arbeitsverzeichnis gefunden werden. Sie müssen legal Ihre Schlüssel erhalten!
Sie können auch die Windows -Binärdateien verwenden. Sie müssen keine externen Bibliotheken installiert und können ausgeführt werden, ohne etwas zu installieren. Sie finden die Binärdateien auf der Release -Seite.
Nach den unten aufgeführten Methoden müssen Sie Python 3.6+ und PIP3 installieren lassen.
Verwenden Sie den folgenden Befehl, um die Nur-Konsolen-Version zu installieren:
pip3 install --upgrade nsz
Verwenden Sie den folgenden Befehl, um die GUI -Version zu installieren:
pip3 install --upgrade nsz[gui]
Das Tool kann auch ausgeführt werden, indem das Repository kloniert, die Anforderungen installiert und dann NSZ mit python3 nsz.py ausgeführt wird
Verwenden Sie den folgenden Befehl, um die Anforderungen an die Konsolenversionen zu installieren:
pip3 install -r requirements.txt
Verwenden Sie den folgenden Befehl, um die Anforderungen an die GUI -Versionen zu installieren:
pip3 install -r requirements-gui.txt
nsz.py --help
usage: nsz.py [-h] [-C] [-D] [-l LEVEL] [-L] [-B] [-S] [-s BS] [-V] [-Q] [-K]
[-F] [-p] [-P] [-t THREADS] [-m MULTI] [-o [OUTPUT]] [-w] [-r]
[--rm-source] [-i] [--depth DEPTH] [-x]
[--extractregex EXTRACTREGEX] [--titlekeys] [--undupe]
[--undupe-dryrun] [--undupe-rename] [--undupe-hardlink]
[--undupe-prioritylist UNDUPE_PRIORITYLIST]
[--undupe-whitelist UNDUPE_WHITELIST]
[--undupe-blacklist UNDUPE_BLACKLIST] [--undupe-old-versions]
[-c CREATE]
[file ...]
positional arguments:
file
options:
-h, --help show this help message and exit
-C Compress NSP/XCI
-D Decompress NSZ/XCZ/NCZ
-l LEVEL, --level LEVEL
Compression Level: Trade-off between compression speed
and compression ratio. Default: 18, Max: 22
-L, --long Enables zStandard long distance mode for even better
compression
-B, --block Use block compression option. This mode allows highly
multi-threaded compression/decompression with random
read access allowing compressed games to be played
without decompression in the future however this comes
with a slightly lower compression ratio cost. This is
the default option for XCZ.
-S, --solid Use solid compression option. Slightly higher
compression ratio but won't allow for random read
access. File compressed this way will never be
mountable (have to be installed or decompressed first
to run). This is the default option for NSZ.
-s BS, --bs BS Block Size for random read access 2^x while x between
14 and 32. Default: 20 => 1 MB
-V, --verify Verifies files after compression raising an unhandled
exception on hash mismatch and verify existing NSP and
NSZ files when given as parameter. Requires --keep
when used during compression.
-Q, --quick-verify Same as --verify but skips the NSP SHA256 hash
verification and only verifies NCA hashes. Does not
require --keep when used during compression.
-K, --keep Keep all useless files and partitions during
compression to allow bit-identical recreation
-F, --fix-padding Fixes PFS0 padding to match the nxdumptool/no-intro
standard. Incompatible with --verify so --quick-verify
will be used instead.
-p, --parseCnmt Extract TitleId/Version from Cnmt if this information
cannot be obtained from the filename. Required for
skipping/overwriting existing files and --rm-old-
version to work properly if some not every file is
named properly. Supported filenames:
*TitleID*[vVersion]*
-P, --alwaysParseCnmt
Always extract TitleId/Version from Cnmt and never
trust filenames
-t THREADS, --threads THREADS
Number of threads to compress with. Numbers < 1
corresponds to the number of logical CPU cores for
block compression and 3 for solid compression
-m MULTI, --multi MULTI
Executes multiple compression tasks in parallel. Take
a look at available RAM especially if compression
level is over 18.
-o [OUTPUT], --output [OUTPUT]
Directory to save the output NSZ files
-w, --overwrite Continues even if there already is a file with the
same name or title id inside the output directory
-r, --rm-old-version Removes older versions if found
--rm-source Deletes source file/s after compressing/decompressing.
It's recommended to only use this in combination with
--verify
-i, --info Show info about title or file
--depth DEPTH Max depth for file info and extraction
-x, --extract Extract a NSP/XCI/NSZ/XCZ/NSPZ
--extractregex EXTRACTREGEX
Regex specifying which files inside the container
should be extracted. Example: "^.*.(cert|tik)$"
--titlekeys Extracts titlekeys from your NSP/NSZ files and adds
missing keys to ./titlekeys.txt and JSON files inside
./titledb/ (obtainable from
https://github.com/blawar/titledb).
--undupe Deleted all duplicates (games with same ID and
Version). The Files folder will get parsed in order so
the later in the argument list the more likely the
file is to be deleted
--undupe-dryrun Shows what files would get deleted using --undupe
--undupe-rename Renames files to minimal standard:
[TitleId][vVersion].nsz
--undupe-hardlink Hardlinks files to minimal standard:
[TitleId][vVersion].nsz
--undupe-prioritylist UNDUPE_PRIORITYLIST
Regex specifying which dublicate deletion should be
prioritized before following the normal deletion
order. Example: "^.*.(nsp|xci)$"
--undupe-whitelist UNDUPE_WHITELIST
Regex specifying which dublicates should under no
circumstances be deleted. Example: "^.*.(nsz|xcz)$"
--undupe-blacklist UNDUPE_BLACKLIST
Regex specifying which files should always be deleted
- even if they are not even a dublicate! Be careful!
Example: "^.*.(nsp|xci)$"
--undupe-old-versions
Removes every old version as long there is a newer one
of the same titleID.
-c CREATE, --create CREATE
Inverse of --extract. Repacks files/folders to an NSP.
Example: --create out.nsp .in
nsz -C /path/to/folder/with/dumps/nsz --verify -C /path/to/folder/with/dumps/nsz --threads 8 --output /path/to/out/dir/ -C /path/to/folder/with/dumps/nsz --level 22 -C /path/to/folder/with/dumps/nsz -D /path/to/folder/with/dumps/Um alle möglichen Flaggen und eine Beschreibung für jedes Flag anzuzeigen, überprüfen Sie den Nutzungsabschnitt.
NSZ -Dateien sind funktional identisch mit NSP -Dateien. Ihr alleiniger Zweck, den Benutzer darüber aufmerksam zu machen, dass er komprimierte NCZ -Dateien enthält. NCZ -Dateien können mit NCA -Dateien im selben Container gemischt werden.
Als Alternative zu diesem Tool unterstützt NSC_Builder auch die Komprimierung von NSP zu NSZ und die Dekomprimierung von NSZ zu NSP. Nsc_builder kann unter https://github.com/julesontheroad/nsc_builder heruntergeladen werden
XCZ -Dateien sind funktional identisch mit XCI -Dateien. Ihr alleiniger Zweck, den Benutzer darüber aufmerksam zu machen, dass er komprimierte NCZ -Dateien enthält. NCZ -Dateien können mit NCA -Dateien im selben Container gemischt werden.
Dies sind komprimierte NCA -Dateien. Die NCAs werden entschlüsselt und dann mit Zstandard komprimiert.
Die ersten 0x4000 -Bytes einer NCZ -Datei sind genau das gleiche wie das ursprüngliche NCA (und immer noch verschlüsselt). Dies gilt auch dann, wenn der erste Abschnitt nicht bei 0x4000 beginnt.
Bei 0x4000 gibt es den NCZ -Header mit variabler Größe. Es enthält eine Liste von Abschnitten, in denen der Dekompressor mitgeteilt wird, wie die NCA-Daten nach der Dekompression erneut entschlüsseln sollen. Es kann auch einen optionalen Block -Komprimierungs -Header enthalten, der zufälligen Lesezugriff ermöglicht.
Alle Informationen im Header können aus dem ursprünglichen NCA + Ticket abgeleitet werden. Es wird jedoch vorgeliefert, um die Dekompression für Dritte so einfach wie möglich zu gestalten.
Direkt nach dem NCZ -Header beginnt der Zstandard -Strom und endet bei EOF. Der Stream ist dekomprimiert, um 0x4000 auszugleichen. Wenn die Blockkomprimierung verwendet wird, wird der Stream in unabhängige Blöcke aufgeteilt und kann wie in https://github.com/nicoboss/nsz/blob/master/nsz/blockdecompressorreader.py dekomprimiert werden. Die komprimierte Blocksizeelistin [Blockid] darf dekomprimiertes BlockSize nicht überschreiten. Wenn kleiner ist, muss der Block dekomprimiert werden. Wenn der Block gleich ist, wird der Block in einfachem Text gespeichert.
class Section :
def __init__ ( self , f ):
self . magic = f . read ( 8 ) # b'NCZSECTN'
self . offset = f . readInt64 ()
self . size = f . readInt64 ()
self . cryptoType = f . readInt64 ()
f . readInt64 () # padding
self . cryptoKey = f . read ( 16 )
self . cryptoCounter = f . read ( 16 )
class Block :
def __init__ ( self , f ):
self . magic = f . read ( 8 ) # b'NCZBLOCK'
self . version = f . readInt8 ()
self . type = f . readInt8 ()
self . unused = f . readInt8 ()
self . blockSizeExponent = f . readInt8 ()
self . numberOfBlocks = f . readInt32 ()
self . decompressedSize = f . readInt64 ()
self . compressedBlockSizeList = []
for i in range ( self . numberOfBlocks ):
self . compressedBlockSizeList . append ( f . readInt32 ())
nspf . seek ( 0x4000 )
sectionCount = nspf . readInt64 ()
for i in range ( sectionCount ):
sections . append ( Section ( nspf ))
if blockCompression :
BlockHeader = Block ( nspf ) NSZ PIP -Paket: https://pypi.org/project/nsz/
Forum-Thread: https://gbatemp.net/threads/nsz-homebrew-compatible-nsp-xci-compressor-decompressor.550556/
SciresMM für seine Hardware -Kryptofunktionen; Die hier erreichten Installationsgeschwindigkeiten (50 MB/s +) wäre ohne diese nicht möglich.
Thanks to our contributors: nicoboss, blawar, plato79, eXhumer, Taorni, anthonyu, teknoraver, KWottrich, gabest11, siddhartha77, alucryd, seiya-git, drizzt, 16BitWonder, 2weak2live, thatch, maki-chan, pR0Ps
