nsz
4.6.1
ZSTD圧縮アルゴリズムのおかげで、ユーザーがNintendo Switchをローズレスに圧縮/減圧できるようにする圧縮/Decompressonスクリプト（オプションのGUIを使用）。圧縮ファイルは、サポートされているNSW Homebrewタイトルインストーラーで直接インストールできます。
このリポジトリのスイスミラーは、https：//gitlab.nicobosshard.ch/nicoboss/nszの下に維持されています
これは、GithubがNSZを倒した場合に備えて、新しい家になります。ブックマークしてください。
このツールをインストールする方法はいくつかあります。以下のすべてのインストールの詳細を見つけることができます。
このツールを使用するには、適切なディレクトリにHactool互換キーファイルが必要です。
キーファイルは%USERPROFILE%/.switch/ （windows）/ $HOME/.switch/ （unix）またはkeys.txtのprod.keysファイルとして、作業ディレクトリに配置する必要があります。合法的に鍵を入手する必要があります！
Windowsバイナリを使用することもできます。外部ライブラリをインストールする必要はなく、何もインストールせずに実行できます。リリースページでバイナリを見つけることができます。
以下にリストされている方法では、Python 3.6+とPIP3をインストールする必要があります。
次のコマンドを使用して、コンソールのみのバージョンをインストールします。
pip3 install --upgrade nsz
次のコマンドを使用して、GUIバージョンをインストールします。
pip3 install --upgrade nsz[gui]
このツールは、リポジトリをクローニングして要件をインストールし、 python3 nsz.py使用してNSZを実行することでも実行できます。
次のコマンドを使用して、コンソールのみのバージョン要件をインストールします。
pip3 install -r requirements.txt
次のコマンドを使用して、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/可能なすべてのフラグと各フラグの説明を表示するには、使用状況セクションを確認してください。
NSZファイルは、NSPファイルと機能的に同一です。圧縮されたNCZファイルが含まれていることをユーザーに警告する唯一の目的。 NCZファイルは、同じコンテナ内のNCAファイルと混合できます。
このツールに代わるものとして、NSC_BuilderはNSPをNSZに圧縮し、NSZをNSPに減圧することもサポートしています。 nsc_builderはhttps://github.com/julesontheroad/nsc_builderからダウンロードできます
XCZファイルは、XCIファイルと機能的に同一です。圧縮されたNCZファイルが含まれていることをユーザーに警告する唯一の目的。 NCZファイルは、同じコンテナ内のNCAファイルと混合できます。
これらは圧縮されたNCAファイルです。 NCAは復号化され、Zstandardを使用して圧縮されます。
NCZファイルの最初の0x4000バイトは、元のNCAとまったく同じです（それでも暗号化されています）。これは、最初のセクションが0x4000から開始されない場合でも適用されます。
0x4000では、可変サイズのNCZヘッダーがあります。これには、減圧後にNCAデータを再クリップする方法を減圧器に伝えるセクションのリストが含まれています。また、ランダム読み取りアクセスを可能にするオプションのブロック圧縮ヘッダーを含めることもできます。
ヘッダー内のすべての情報は、元のNCA +チケットから導き出すことができますが、第三者にとって可能な限り簡単に減圧を行うために事前に録音されています。
NCZヘッダーの直後、ZStandardストリームはEOFで始まり、終了します。ストリームは、0x4000をオフセットするために減圧されます。ブロック圧縮を使用すると、ストリームは独立したブロックに分割され、https：//github.com/nicoboss/nsz/blob/master/nsz/blockdecompressorreader.pyに示されているように解凍できます。 CompressedBlockSizElist [BlockID]は、減圧BlockSizeを超えてはなりません。小さい場合は、ブロックを減圧する必要があります。等しい場合、ブロックはプレーンテキストに保存されます。
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パッケージ：https：//pypi.org/project/nsz/
フォーラムスレッド：https：//gbatemp.net/threads/nsz-homebrew-compatible-nsp-xci-compressor-decompressor.550556/
彼のハードウェア暗号機能のsciresm;ここで達成された燃えるようなインストール速度（50 mb/秒）は、これなしでは不可能です。
ニコボス、ブラワール、プラト79、エベーザー、タルニ、アンソニュ、テクノーバー、クォトリッチ、ガベスト11、シッダルタ77、アルクリッド、セイヤギット、ドリッツ、16ビットウォンダー、2ウィーク2live、その貢献者のおかげで
