nsz
4.6.1
Un script de compresión/Decompresson (con GUI opcional) que permite al usuario comprimir/descomprimir el interruptor de Nintendo descarga de manera inyecta, gracias al algoritmo de compresión ZSTD. El archivo comprimido se puede instalar directamente con los instaladores de título nsw nsw nsw.
Un espejo suizo de este repositorio se mantiene en https://gitlab.nicobosshard.ch/nicoboss/nsz
Este será el nuevo hogar en caso de que Github haya derrotado a NSZ. Por favor, marquelo.
Hay varias formas de instalar esta herramienta. Puede encontrar detalles sobre la instalación para todos ellos a continuación.
Debe tener un archivo de claves compatibles con Hactool en un directorio adecuado para usar esta herramienta .
El archivo de teclas debe ubicarse como archivo prod.keys en %USERPROFILE%/.switch/ (windows)/ $HOME/.switch/ (unix) o keys.txt en el directorio de trabajo. ¡Debes obtener legalmente tus llaves!
También puede usar los binarios de Windows. No requieren que se instalarán ninguna biblioteca externa y se pueden ejecutar sin instalar nada. Puede encontrar los binarios en la página de lanzamiento.
Los métodos enumerados a continuación requieren que tenga instalados Python 3.6+ y PIP3.
Use el siguiente comando para instalar la versión solo de consola:
pip3 install --upgrade nsz
Use el siguiente comando para instalar la versión GUI:
pip3 install --upgrade nsz[gui]
La herramienta también se puede ejecutar clonando el repositorio, instalando los requisitos y luego ejecutando NSZ utilizando python3 nsz.py
Use el siguiente comando para instalar los requisitos de versiones de solo consola:
pip3 install -r requirements.txt
Use el siguiente comando para instalar los requisitos de versiones de 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/Para ver todas las banderas posibles y una descripción de lo que cada bandera, verifique la sección de uso.
Los archivos NSZ son funcionalmente idénticos a los archivos NSP. Su único propósito de alertar al usuario de que contiene archivos NCZ comprimidos. Los archivos NCZ se pueden mezclar con archivos NCA en el mismo contenedor.
Como alternativa a esta herramienta, NSC_Builder también admite comprimir NSP a NSZ y descomprimir NSZ a NSP. Nsc_builder se puede descargar en https://github.com/julesonteroad/nsc_builder
Los archivos XCZ son funcionalmente idénticos a los archivos XCI. Su único propósito de alertar al usuario de que contiene archivos NCZ comprimidos. Los archivos NCZ se pueden mezclar con archivos NCA en el mismo contenedor.
Estos son archivos NCA comprimidos. Los NCA se descifran y luego se comprimen usando Zstandard.
Los primeros 0x4000 bytes de un archivo NCZ es exactamente el mismo que el NCA original (y aún encriptado). Esto se aplica incluso si la primera sección no comienza en 0x4000.
A 0x4000, existe el encabezado NCZ de tamaño variable. Contiene una lista de secciones que le dicen al descompresor cómo volver a encriptar los datos de la NCA después de la descompresión. También puede contener un encabezado de compresión de bloque opcional que permite el acceso de lectura aleatorio.
Toda la información en el encabezado puede derivarse del boleto NCA + original, sin embargo, se proporciona prepasado para hacer que la descompresión sea lo más fácil posible para terceros.
Directamente después del encabezado NCZ, la transmisión del Estado de la Zanja comienza y termina en EOF. La transmisión se descomprime para compensar 0x4000. Si se usa la compresión de bloques, la transmisión se divide en bloques independientes y se puede descomprimir como se muestra en https://github.com/nicoboss/nsz/blob/master/nsz/blockdecompressorreader.py. CompressedBlockSizelist [blockid] no debe exceder el descomprimido BLOCKSize. Si es más pequeño, el bloque debe descomprimirse. Si es igual, el bloque se almacena en texto plano.
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 ) Paquete NSZ PIP: https://pypi.org/project/nsz/
Hilo del foro: https://gbatemp.net/threads/nsz-homebrew-compatible-nsp-xci-compressor-decompressor.550556/
SciresM por sus funciones de criptográfico de hardware; Las velocidades de instalación de Blazing (50 MB/seg +) logradas aquí no serían posibles sin esto.
Gracias a nuestros contribuyentes: Nicoboss, Blawar, Platón79, Exhumer, Taorni, Anthonyu, Teknoraver, Kwottrich, Gabest11, Siddhartha77, Alucryd, Seiya-Git, Drizzt, 16bitwonder, 2Weak2live, thatch, Maki-Chan, Pr0psps, Pr0psps,
