NXDumpTool Switch

nxdumptool
File:Nxdumptoolswitch.png
General
Author	DarkMatterCore
Type	Utilities
Version	1.1.15
License	GPL-2.0
Last Updated	2022/02/25
Links
Download
Website
Source
Support Author

Generates XCI/NSP/HFS0/ExeFS/RomFS/Certificate/Ticket dumps from Nintendo Switch gamecards and installed SD/eMMC titles.

Features

• Generates full Cartridge Image dumps (XCI) with optional certificate removal and/or trimming.
• Generates installable Nintendo Submission Packages (NSP) from base applications, updates and DLCs stored in the inserted gamecard, SD card and eMMC storage devices.
  • The generated dumps follow the AuditingTool format from Scene releases.
  • Capable of generating dumps without console specific information (common ticket).
  • Capable of generating ticket-less (standard crypto) dumps.
  • Capable of generating dumps from installed updates/DLCs with missing base applications (orphan titles).
  • Compatible with game pre-installs.
  • Batch mode available, with customizable dump settings.
• Manual gamecard certificate dump.
• Manual ticket dump from installed SD/eMMC titles + optional removal of console specific data.
• Compatible with multigame carts.
• CRC32 checksum calculation for XCI/NSP dumps.
• XCI/NSP dump verification through CRC32 checksum lookup.
  • Using offline XML database from NSWDB.COM (NSWreleases.xml) (XCI only).
  • Performing an online lookup against the No-Intro database.
• Bundled-in update capabilities via libcurl.
  • Update to the latest version by downloading it right from GitHub.
  • Update the NSWDB.COM XML database.
• Precise HFS0 raw partition dumping, using the root HFS0 header from the gamecard.
• HFS0 partition file data dumping + browser with manual file dump support.
• Program NCA ExeFS/RomFS section & Data NCA RomFS section file data dumping + browser with manual file dump support.
  • Compatible with base applications, updates and DLCs (if available).
  • Supports manual RomFS directory dumping.
• Free SD card space checks in place.
• File splitting support for all operations.
  • Capable of storing split XCI/NSP dumps in directories with the archive bit set.
• Sequential (multi-session) dump support, in case there's not enough storage space available for a XCI/NSP full dump.
• Metadata retrieval using NCM and NS services.
• Dump speed calculation, ETA calculation and progress bar.

Installation

Place the .nro to the /switch/ folder on the SD card.

Operations related to installed SD/eMMC titles require a keys file located at "sdmc:/switch/prod.keys". Use Lockpick RCM to generate it.

Please launch the application through title override (hold R while launching a game) whenever possible to avoid memory allocation problems.

Screenshots

Disclaimer

• Doesn't work under 1.0.0, and probably never will. The application needs IPC calls that are only available from 2.0.0 onwards.
• Doesn't work under FW > 1.0.0 and < 4.0.0 if the application is launched using PegaSwitch. This is because PegaSwitch doesn't give full access permissions to the application. Please use PegaScape to reboot your console into a full fledged CFW if you wish to use the application.
• NSP/ExeFS/RomFS features require the "sdmc:/switch/prod.keys" file. Use Lockpick RCM to generate it.
• If you go back to Horizon and get an error or black screen when trying to launch the inserted gamecard, just pull it out and re-insert it. No reboot needed. Any help on fixing this bug will be greatly appreciated.

Changelog

v.1.0

• First Release.

Credits

Thanks to:

• MCMrARM, for creating the original application.
• RSDuck, for vba-next-switch port. It's UI menu code was taken as a basis for this application.
• foen, for giving me some pretty good hints about how to use the NCM service.
• yellows8, for helping me fix a silly bug in my implementation of some NCM service IPC calls.
• SciresM, for hactool (licensed under ISC). It's NCA content handling procedures are reproduced in many parts of the application.
• The-4n, for 4NXCI (licensed under ISC) and hacPack (licensed under GPLv2). The NCA content patching procedure used in 4NXCI is replicated in the application, as well as the NACP XML generation from hacPack.
• shchmue, for Lockpick (licensed under GPLv2). It is used as a reference for the runtime key-collection algorithm needed for the NSP dump, ExeFS dump/browse and RomFS dump/browse procedures.
• Björn Samuelsson, for his public domain CRC32 checksum calculation C-code.
• Adubbz, for Tinfoil (licensed under MIT). Its wrappers for ES service IPC calls are used in the application.
• WerWolv, for the SX OS detection procedure used in EdiZon (licensed under [https://github.com/WerWolv/EdiZon/blob/master/LICENSE GPLv2).
• ChaN, for the FatFs module (licensed under FatFs license). It is used to read ES savedata files from the BIS System partition.
• hthh, for his switch-reversing repository, which was very helpful to understand how to parse and read information from NSO binaries.
• The LZ4 project, for the LZ4 C-code implementation (licensed under BSD 2-Clause).
• AnalogMan and 0Liam, for their constant support and ideas.
• RattletraPM, for the awesome icon used in the application.
• FennecTECH, for testing / breaking stuff inside the application on a regular basis.
• The folks from NSWDB.COM and No-Intro.org, for being kind enough to put up a HTTP(S) endpoint(s) to perform CRC32 checksum lookups.
• The GNOME project, from which the high contrast icons were retrieved.
• The folks from ReSwitched, for working towards the creation of a good homebrew ecosystem.
• The Comfy Boyes, for being both awesome and supportive. You know who you are.
• My girlfriend, for putting up with me even though I dedicate most of my free time to this little project, and for doing her best to cheer me up and keep me going. I love you.

External links

• GitHub - https://github.com/DarkMatterCore/nxdumptool
• GBAtemp - https://gbatemp.net/threads/nxdumptool-nintendo-switch-dump-tool.508343/
• ForTheUsers - https://apps.fortheusers.org/switch/gcdumptool
• Discord - https://discord.gg/SCbbcQx