nstool/README.md
2018-05-27 18:56:47 +08:00

1.3 KiB

NXTools

Tools & Libraries for NX (Nintendo Switch).

License

Tools

  • nstool - read *.npdm, read/extract PartitionFS (PFS0|HFS0) blobs (including *.nsp), read/extract *.xci, read/extract *.nca, read *.cnmt

Libraries

  • libfnd - Foundation library.
  • libcrypto - Cryptographic functions (AES,SHA,RSA). Wrapper for mbedTLS
  • libes - Handling of (NX relevant) eShop file type processing. (eTickets, etc)
  • libnx - Handling of NX file types

Building

On MacOS/Linux/WSL run make.

For Windows, Visual Studio 2017 is supported.

External Keys

Programs/libraries don't embed any keys that are copyright protected. However keys can be imported via a keyset file.

For programs that support it, the keyset file can be provided via the command line (see program usage for details). Alternatively a keyset file located in $HOME/.switch/prod.keys (or $HOME/.switch/dev.keys for dev) will be imported automatically if one is not provided at the command line.

Keyset files are ASCII text files containing one key per line, in the form "key_name = HEXADECIMALKEY". Case and whitespace do not matter, ';' character can be used to insert comments.

See KEYS.md for more details.