nsz
4.6.1
Un script de compression / décompresseur (avec une interface graphique en option) qui permet à l'utilisateur de compresser / décompresser le commutateur Nintendo vide sans loss, grâce à l'algorithme de compression ZSTD. Le fichier compressé peut être installé directement avec les installateurs de titre Homebrew NSW pris en charge.
Un miroir suisse de ce référentiel est maintenu sous https://gitlab.nicobosshard.ch/nicoboss/nsz
Ce sera la nouvelle maison au cas où Github éliminera NSZ. Veuillez le mettre en signet.
Il existe plusieurs façons d'installer cet outil. Vous pouvez trouver des détails sur l'installation pour tous ci-dessous.
Vous devez avoir un fichier de touches compatibles Hactool dans un répertoire approprié pour utiliser cet outil .
Le fichier Keys doit être situé en tant que fichier prod.keys dans %USERPROFILE%/.switch/ (Windows) / $HOME/.switch/ (UNIX) ou keys.txt dans le répertoire de travail. Vous devez légalement obtenir vos clés!
Vous pouvez également utiliser les binaires Windows. Ils ne nécessitent pas d'installation de bibliothèques externes et peuvent être exécutées sans rien installer. Vous pouvez trouver les binaires dans la page de version.
Les méthodes répertoriées ci-dessous vous obligent à installer Python 3.6+ et PIP3.
Utilisez la commande suivante pour installer la version console uniquement:
pip3 install --upgrade nsz
Utilisez la commande suivante pour installer la version GUI:
pip3 install --upgrade nsz[gui]
L'outil peut également être exécuté en clonage le référentiel, en installant les exigences puis en exécutant NSZ à l'aide de python3 nsz.py
Utilisez la commande suivante pour installer les exigences de versions uniquement sur la console:
pip3 install -r requirements.txt
Utilisez la commande suivante pour installer les exigences des versions GUI:
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/Pour afficher tous les drapeaux possibles et une description de chaque indicateur, vérifiez la section d'utilisation.
Les fichiers NSZ sont fonctionnellement identiques aux fichiers NSP. Leur seul but d'alerter l'utilisateur qu'il contient des fichiers NCZ compressés. Les fichiers NCZ peuvent être mélangés avec des fichiers NCA dans le même conteneur.
En tant qu'alternative à cet outil, NSC_BUILDER prend également en charge la compression de NSP vers NSZ et la décompression de NSZ vers NSP. NSC_BUilder peut être téléchargé sur https://github.com/julesontheroad/nsc_builder
Les fichiers XCZ sont fonctionnellement identiques aux fichiers XCI. Leur seul but d'alerter l'utilisateur qu'il contient des fichiers NCZ compressés. Les fichiers NCZ peuvent être mélangés avec des fichiers NCA dans le même conteneur.
Ce sont des fichiers NCA compressés. Les NCA sont déchiffrées, puis compressées à l'aide de Zstandard.
Les premiers octets 0x4000 d'un fichier NCZ sont exactement les mêmes que la NCA d'origine (et toujours cryptée). Cela s'applique même si la première section ne démarre pas à 0x4000.
À 0x4000, il y a l'en-tête NCZ de taille variable. Il contient une liste de sections qui indiquent au décompresseur comment réencroiter les données NCA après décompression. Il peut également contenir un en-tête de compression en bloc en option permettant un accès à lecture aléatoire.
Toutes les informations dans l'en-tête peuvent être dérivées du billet NCA + d'origine, mais elles sont fournies pré-payées pour rendre la décompression aussi simple que possible pour les tiers.
Directement après l'en-tête NCZ, le flux Zstandard commence et se termine à EOF. Le flux est décompressé pour compenser 0x4000. Si la compression des blocs est utilisée, le flux est divisé en blocs indépendants et peut être décompressé comme indiqué dans https://github.com/nicoboss/nsz/blob/master/nsz/blockdecompressorreader.py. CompresticBlockSizeList [Blockid] ne doit pas dépasser leblocksize de décompressement. En cas de plus petit, le bloc doit être décompressé. S'il est égal, le bloc est stocké en texte brut.
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 ) Package NSZ PIP: https://pypi.org/project/nsz/
Thread de forum: https://gbatemp.net/threads/nsz-homebrew-compatible-nsp-xci-compressor-decompressor.550556/
Sciresm pour ses fonctions de crypto matérielle; Les vitesses d'installation flamboyantes (50 Mo / sec +) obtenues ici ne seraient pas possibles sans cela.
Merci à nos contributeurs: Nicoboss, Blawar, Plato79, exhummer, Taorni, Anthonyu, Teknoraver, Kwottrich, Gabest11, Siddhartha77, Alucryd, Seiya-git, Drizzt, 16bitwonder, 2weak2live, thatch, maki-chan, pr0ps
