nsz
4.6.1
Skrip kompresi/dekompresson (dengan GUI opsional) yang memungkinkan pengguna untuk mengompres/mendekompres nintendo switch dump dengan los tanpa losiph, berkat algoritma kompresi ZSTD. File terkompresi dapat diinstal secara langsung dengan pemasang judul NSW Homebrew yang didukung.
Sebuah cermin Swiss dari repositori ini dipertahankan di bawah https://gitlab.nicobosshard.ch/nicoboss/nsz
Ini akan menjadi rumah baru jika GitHub pernah menurunkan NSZ. Tolong bookmarknya.
Ada beberapa cara menginstal alat ini. Anda dapat menemukan detail tentang instalasi untuk semuanya di bawah ini.
Anda perlu memiliki file tombol yang kompatibel dengan Hactool di direktori yang sesuai untuk menggunakan alat ini .
File Keys harus ditempatkan sebagai file prod.keys di %USERPROFILE%/.switch/ (windows)/ $HOME/.switch/ (unix) atau keys.txt di direktori kerja. Anda harus secara hukum mendapatkan kunci Anda!
Anda juga dapat menggunakan binari Windows. Mereka tidak memerlukan pustaka eksternal untuk diinstal dan dapat dijalankan tanpa menginstal apa pun. Anda dapat menemukan binari di halaman rilis.
Metode yang tercantum di bawah ini mengharuskan Anda memasang Python 3.6+ dan PIP3.
Gunakan perintah berikut untuk menginstal versi konsol saja:
pip3 install --upgrade nsz
Gunakan perintah berikut untuk menginstal versi GUI:
pip3 install --upgrade nsz[gui]
Alat ini juga dapat dijalankan dengan mengkloning repositori, memasang persyaratan dan kemudian mengeksekusi NSZ menggunakan python3 nsz.py
Gunakan perintah berikut untuk menginstal persyaratan versi konsol saja:
pip3 install -r requirements.txt
Gunakan perintah berikut untuk menginstal Persyaratan Versi 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/Untuk melihat semua bendera yang mungkin dan deskripsi tentang apa yang masing -masing bendera, periksa bagian penggunaan.
File NSZ secara fungsional identik dengan file NSP. Satu -satunya tujuan mereka untuk mengingatkan pengguna bahwa itu berisi file NCZ terkompresi. File NCZ dapat dicampur dengan file NCA dalam wadah yang sama.
Sebagai alternatif untuk alat ini NSC_BUILDER juga mendukung pengompresi NSP ke NSZ, dan mendekompresi NSZ ke NSP. Nsc_builder dapat diunduh di https://github.com/julesontheroad/nsc_builder
File XCZ secara fungsional identik dengan file XCI. Satu -satunya tujuan mereka untuk mengingatkan pengguna bahwa itu berisi file NCZ terkompresi. File NCZ dapat dicampur dengan file NCA dalam wadah yang sama.
Ini adalah file NCA terkompresi. NCA didekripsi, dan kemudian dikompresi menggunakan zstandard.
Byte 0x4000 pertama dari file NCZ persis sama dengan NCA asli (dan masih dienkripsi). Ini berlaku bahkan jika bagian pertama tidak dimulai dari 0x4000.
Pada 0x4000, ada header NCZ berukuran variabel. Ini berisi daftar bagian yang memberi tahu dekompresor cara merukas ulang data NCA setelah dekompresi. Ini juga dapat berisi header kompresi blok opsional yang memungkinkan akses baca acak.
Semua informasi di header dapat diturunkan dari tiket NCA + asli, namun disediakan pra-parit untuk membuat dekompresi semudah mungkin bagi pihak ketiga.
Langsung setelah header NCZ, aliran ZStandard dimulai dan berakhir di EOF. Aliran didekompresi untuk mengimbangi 0x4000. Jika kompresi blok digunakan, aliran dibagi menjadi blok independen dan dapat didekompresi seperti yang ditunjukkan pada https://github.com/nicoboss/nsz/blob/master/nsz/blockdecompressorreader.py. CompressedBlockSizeList [blockid] tidak boleh melebihi decompressblocksize. Jika lebih kecil blok harus didekompresi. Jika sama dengan blok disimpan dalam teks biasa.
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 ) Paket Pip NSZ: https://pypi.org/project/nsz/
Thread Forum: https://gbatemp.net/threads/nsz-homebrew-compatible-nsp-xci-compressor-decompressor.550556/
Sciresm untuk fungsi crypto perangkat kerasnya; Kecepatan instalasi Blazing (50 MB/detik +) yang dicapai di sini tidak akan mungkin tanpa ini.
Terima kasih kepada kontributor kami: Nicoboss, Blawar, Plato79, Exhumer, Taorni, Anthonyu, Teknoraver, Kwottrich, Gabest11, Siddhartha77, Alucryd, Seiya-git, Drizzt, 16bitwonder, 2weak2live, Thatch, MAKI-CHAN, PR0P0, 2WEAKS, Thatch, Thatch, MAKI-CHAN, PR0P0SPSPS, 2WEAKS, Thatch, MAKI-CHAN, PR0PSPS, PR0
