nsz
4.6.1
Um script de compactação/descompresson (com GUI opcional) que permite ao usuário compactar/descompactar o Nintendo Switch Dumps sem largamente, graças ao algoritmo de compactação ZSTD. O arquivo compactado pode ser instalado diretamente com os instaladores de título de homebrew NSW suportados.
Um espelho suíço deste repositório é mantido em https://gitlab.nicobosshard.ch/nicoboss/nsz
Esta será a nova casa, caso o Github já derruba a NSZ. Por favor, marque -o.
Existem várias maneiras de instalar esta ferramenta. Você pode encontrar detalhes sobre a instalação para todos eles abaixo.
Você precisa ter um arquivo de chaves compatíveis com Hactool em um diretório adequado para usar esta ferramenta .
O arquivo das chaves deve estar localizado como arquivo prod.keys em %USERPROFILE%/.switch/ (windows)/ $HOME/.switch/ (unix) ou keys.txt no diretório de trabalho. Você deve obter legalmente suas chaves!
Você também pode usar os binários do Windows. Eles não exigem que nenhuma biblioteca externa seja instalada e pode ser executada sem instalar nada. Você pode encontrar os binários na página de liberação.
Os métodos listados abaixo exigem que você tenha o Python 3.6+ e o PIP3 instalados.
Use o seguinte comando para instalar a versão somente console:
pip3 install --upgrade nsz
Use o seguinte comando para instalar a versão da GUI:
pip3 install --upgrade nsz[gui]
A ferramenta também pode ser executada clonando o repositório, instalando os requisitos e executando o NSZ usando python3 nsz.py
Use o comando a seguir para instalar os requisitos de versões somente para console:
pip3 install -r requirements.txt
Use o seguinte comando para instalar os requisitos das versões da 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 visualizar todos os sinalizadores possíveis e uma descrição sobre o que cada sinalizador, verifique a seção de uso.
Os arquivos NSZ são funcionalmente idênticos aos arquivos NSP. Seu único objetivo de alertar o usuário de que ele contém arquivos NCZ compactados. Os arquivos NCZ podem ser misturados com arquivos NCA no mesmo contêiner.
Como alternativa a essa ferramenta, o NSC_Builder também suporta compactar o NSP ao NSZ e descomprimir o NSZ ao NSP. NSC_Builder pode ser baixado em https://github.com/julesontheroad/nsc_builder
Os arquivos XCZ são funcionalmente idênticos aos arquivos XCI. Seu único objetivo de alertar o usuário de que ele contém arquivos NCZ compactados. Os arquivos NCZ podem ser misturados com arquivos NCA no mesmo contêiner.
Estes são arquivos NCA compactados. As NCAs são descriptografadas e depois compactadas usando o Zstandard.
Os primeiros bytes 0x4000 de um arquivo NCZ são exatamente os mesmos da NCA original (e ainda criptografados). Isso se aplica mesmo que a primeira seção não comece a 0x4000.
A 0x4000, existe o cabeçalho NCZ de tamanho variável. Ele contém uma lista de seções que dizem ao descompressor como criar os dados da NCA após a descompressão. Ele também pode conter um cabeçalho de compressão de bloco opcional, permitindo acesso aleatório de leitura.
Todas as informações no cabeçalho podem ser derivadas do ticket NCA + original, no entanto, é fornecida pré-paralisada para facilitar o mais fácil possível para terceiros.
Diretamente após o cabeçalho da NCZ, o riacho Zstandard começa e termina em EOF. O fluxo é descomprimido para compensar 0x4000. Se a compactação de bloco for usada, o fluxo for dividido em blocos independentes e pode ser descomprimido, como mostrado em https://github.com/nicoboss/nsz/blob/master/nsz/blockdecompressorreader.py. O CompressedBlockSizelist [BlockID] não deve exceder o BlockSize descompactado. Se menor o bloco deve ser descomprimido. Se for igual, o bloco é armazenado em texto simples.
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 ) Pacote NSZ PIP: https://pypi.org/project/nsz/
Tópico do fórum: https://gbatemp.net/threads/nsz-homebrew-compatible-nsp-xci-compressor-decompressor.550556/
Sciresm para suas funções de criptografia de hardware; As velocidades de instalação em chamas (50 mb/s +) alcançadas aqui não seriam possíveis sem isso.
Graças aos nossos colaboradores: Nicoboss, Blawar, Platão79, Exumer, Taorni, Anthonyu, Teknoraver, Kwottrich, Gabest11, Siddhartha77, Alucryd, Seiya-Git, Drizzt, 16bitwonder, 2Weak2live, Thatch, Maki-chan,
