NSZ è un utilissimo script python sviluppato dal developer Nico Bosshard che ci permette di comprimere e decomprimere i file .nsz da poter poi utilizzare sulla console Switch.

I file NSZ sono sostanzialmente identici ai file NSP, questo significa che non sono realmente un nuovo formato. Il loro unico scopo è quello di avvisare l’utente che contiene file NCZ compressi. I file NCZ possono essere miscelati con file NCA nello stesso contenitore.

NSC_Builder supporta la compressione di file NSP in NSZ e la decompressione di file NSZ in NSP. Gli script di esempio che si trovano qui sono solo esempi di come funziona il formato. NSC_Builder può essere scaricato da questo link.

XCZ

I file XCZ, come per i file NSZ sono sostanzialmente identici ai file XCI, questo significa che anche loro non sono realmente un nuovo formato. Il loro unico scopo è quello di avvisare l’utente che contiene file NCZ compressi. I file NCZ possono essere miscelati con file NCA nello stesso contenitore.

NCZ

Questi sono file NCA compressi. I file ANC vengono decodificati e quindi compressi mediante zstandard. Sono supportate solo le ANC con un’intestazione di 0x4000 byte (le CNNT non sono supportate).

I primi 0x4000 byte di un file NCZ sono esattamente gli stessi del file NCA originale (anche questa è ancora crittografata).

A 0x4000, ci sarà una struttura di intestazione NCZ di dimensioni variabili. Questa intestazione contiene un elenco di sezioni che indicano al decompressore come ri-crittografare i dati NCA dopo la decompressione.

Tutte le informazioni nell’intestazione possono essere derivate dal Ticket NCA + originale, tuttavia vengono fornite pre-preparate per rendere la decompressione il più semplice possibile per terze parti.

Immediatamente dopo l’intestazione NCZ, il flusso zstandard inizia e termina in EOF. Il flusso viene decompresso per compensare 0x4000.

class NczHeader
{
public:
       class Section
       {
       public:
              u64 offset;
              u64 size;
              u8 cryptoType;
              u8 padding1[7];
              u64 padding2;
              integer<128> cryptoKey;
              integer<128> cryptoCounter;
       } PACKED;
       const bool isValid()
       {
              return m_magic == MAGIC && m_sectionCount < 0xFFFF;
       }

       const u64 size() const
       {
              return sizeof(m_magic) + sizeof(m_sectionCount) + sizeof(Section) * m_sectionCount;
       }

       const Section& section(u64 i) const
       {
              return m_sections[i];
       }

protected:
       u64 m_magic;
       u64 m_sectionCount;
       Section m_sections[1];

       static const u64 MAGIC = 0x4E544345535A434E;
} PACKED;

Installazione

• Inserire il file prod.keys scaricato in %userprofile%/.switch, installare python, eseguire il comando pip install nsz e utilizzare nsz come qualsiasi altro comando cmd.
  • Volendo è possibile utilizzare semplicemente la build portatile di Windows.
• Per installare manualmente le dipendenze utilizzare invece il comando: pip install -r requirements.txt

Script del compressore

Lo script necessita delle chiavi keys.txt compatibile con hactool che deve essere presente nella stessa directory del file nsz.py. Attualmente funziona solo con giochi base, aggiornamenti e DLC.

Esempio di utilizzo: nsz.py --level 17 -C title1.nsp title2.nsp title3.nsp

Questo genererà i file title1.nsz, title2.nsz, title3.nsz

Requisiti Python

py -3 -m pip install -r requirements.txt

Guida

nsz.py --help
usage: nsz.py [-h] [-i INFO] [--depth DEPTH] [-N VERIFY_NCAS]
              [-x EXTRACT [EXTRACT ...]] [-c CREATE] [-C] [-D] [-l LEVEL]
              [-b BLOCK] [-s BS] [-t THREADS] [-o OUTPUT]
              [file [file ...]]

positional arguments:
   file

optional arguments:
  -h, --help       show this help message and exit
  -i INFO, --info  INFO show info about title or file
  --depth DEPTH    max depth for file info and extraction
  -N VERIFY_NCAS, --verify-ncas VERIFY_NCAS
                   Verify NCAs in container
  -x EXTRACT [EXTRACT ...], --extract EXTRACT [EXTRACT ...]
                   extract / unpack a NSP
  -c CREATE, --create CREATE
                   create / pack a NSP
  -C               Compress NSP
  -D               Decompress NSZ
  -l LEVEL, --level LEVEL
                   Compression Level
  -b BLOCK, --block BLOCK
                   Uses highly multithreaded block compression with
                   random read access allowing compressed games to be
                   played without decompression in the future however
                   this comes with a low compression ratio cost. Current
                   title installers do not support this yet.
  -s BS, --bs BS Block Size for random read access 2^x while x between
                   14 and 32. Default is 19 => 512 KB. Current title
                   installers do not support this yet.
  -t THREADS, --threads THREADS
                   Number of threads to compress with. Usless without
                   enabeling block compression using -b. Negative
                   corresponds to the number of logical CPU cores.
  -o OUTPUT, --output OUTPUT
                   Directory to save the output NSZ files

## Credits

SciresM for his hardware crypto functions; the blazing install speeds (50 MB/sec +) achieved here would not be possible without this.

Nicoboss for the original awesome idea. https://github.com/nicoboss/nsZip/

Changelog v3.1.1

• Corretta la decompressione e la verifica dei file XCZ.

Changelog v3.1

• Correzione della decompressione interrotta nella versione 3.0.0 a causa di un argomento facoltativo non contrassegnato come tale e di un confronto delle estensioni di file non aggiornato.
• Consentita la selezione di singoli file all’interno di OpenFileDialog.
• Reso visibile quale unità è attualmente selezionata all’interno di OpenFileDialog e SaveFileDialog.
• Sostituita l’immagine background_down con background_normal in quanto appare brutta all’interno dei FileDialogs.
• Rimosso SaveFileDialog come inutilizzato e un dolore da mantenere.
• Migliorato notevolmente OpenFileDialog consentendo il passaggio tra l’icona e il layout dell’elenco.
• Aggiunto filtro a OpenFileDialog in modo che visualizzi solo i file nsp, nsz, xci, xcz e ncz.
• L’applicazione ora non mostra più il segnaposto vuoto per la selezione del dispositivo su piattaforme non Windows e sono possibili filtri file specificabili per argomento OpenFileDialog.
• Finalmente abilitata la selezione di cartelle e la selezione di più elementi contemporaneamente.
• Creazione automatica della cartella GUI vuota richiesta per il salvataggio delle impostazioni in nsz portable, che è esattamente la correzione applicata manualmente a nsz_v3.0.0_hotfix1_win64_portable.zip.
• Corretti gli avvisi che apparivano nella console ad ogni avvio della GUI.
• I pulsanti della modalità di visualizzazione del browser dei file sono stati realizzati con lo stesso design dei pulsanti di selezione del dispositivo Windows.
• Implementata l’eliminazione degli elementi dalla GameList selezionati usando il tasto Canc o Backspace.
• Migliorata notevolmente la selezione e la cancellazione degli oggetti dalla GameList.
• Modalità di verifica Vixed non in esecuzione quando chiamata dalla GUI.
• Imposta la quantità predefinita di thread per la compressione solida su 3 mantenendo il numero di core logici predefinito per la compressione a blocchi poiché la maggior parte ora utilizza la parallelizzazione delle attività per la compressione solida.
• Corretto: AttributeError: l’oggetto ‘RootWidget’ non ha attributo ‘verify’.
• Corretto Kivy che lancia “Error in sys.excepthook” durante l’arresto se la quantità di dati di RecycleView era in diminuzione.
• Migliorata la formulazione del riepilogo degli errori.
• Aggiornati gli script di test e distribuzione.
• Corretti i processi orfani che rimanevano dopo che il processo principale veniva terminato dopo la compressione del blocco di un’attività molto breve che causava lo spamming dei processi orfani “AttributeError: ‘ForkAwareLocal’ object has no attribute ‘connection'”.
• Corretto il problema con l’icona della GUI NSZ non visualizzata.
• Miglioramenti generali della stabilità del sistema per migliorare l’esperienza dell’utente.

Download: NSZ v3.1.1 [Win64]

Download: Source code NSZ v3.1.1

Fonte: github.com