mirrors/nxdumptool
1
0
Fork 0
mirror of https://github.com/DarkMatterCore/nxdumptool.git synced 2024-11-22 10:16:39 +00:00
Code Issues Releases Activity
Generates XCI/NSP/HFS0/ExeFS/RomFS/Certificate/Ticket dumps from Nintendo Switch gamecards and installed SD/eMMC titles.
484 commits 3 branches 26 tags 8.7 MiB
C 92.9%
C++ 5.2%
Python 1.6%
Makefile 0.2%
Find a file
Pablo Curiel fb58d20fe3 I'm a terrible person and an even worse developer. 
And I don't need anyone to tell me so, thank you very much.

* PoC: remove gc_dumper and nsp_dumper PoC; create nxdt_rw_poc with all gc_dumper and nsp_dumper capabilities + standalone ticket dumping + raw NCA dumping; use ftruncate() to set output file sizes whenever possible. PoC code is a mess, as always. Expect the features from the rest of the PoCs to be implemented into nxdt_rw_poc soon.

* workflow: temporarily disable borealis build generation; comment out manual installation of up-to-date packages from Leseratte's mirrors because the latest devkitA64 Docker image has them all.

* borealis: update to fix building issues with latest devkitA64.

* bfttf: error out on invalid NCA signatures.

* config: save configuration to the current working directory; parse and validate new "gamecard/write_raw_hfs_partition" flag.

* defines: remove CONFIG_PATH macro; rename CONFIG_FILE_NAME.

* gamecard: rename fs_ctx -> hfs_ctx everywhere; use HFS function calls to retrieve partition names.

* hfs: move GameCardHashFileSystemPartitionType enum from gamecard.h and rename it to HashFileSystemPartitionType; add hfsIsValidContext(); add hfsGetPartitionNameString().

* nca/npdm: update comments to reflect latest HOS version.

* nxdt_bfsar: always generate absolute SD card paths with the device name; error out on an invalid NCA signature.

* nxdt_includes: include dirent.h; refactor Version struct to make it a union of all known *Version structs.

* nxdt_log: don't write session separator if the logfile is empty.

* nxdt_utils: log appletIsGamePlayRecordingSupported() errors; add utilsDeleteDirectoryRecursively().

* rsa: provide clearer function descriptions in header file.

* services: handle usb:ds initialization.

* tik: update tikConvertPersonalizedTicketToCommonTicket() to allow NULL input pointers as raw certificate chain arguments (much needed for standalone ticket dumping).

* title: add titleGetApplicationIdByMetaKey().

* usb: refactor interface (de)initialization code; slightly improve ABI usage (console-side only); redefine ABI version field in StartSession command blocks; upgrade ABI to v1.1.

* FatFs: rename DIR -> FDIR to avoid conflicts with definitions from stdlib's dirent.h.

* gamecard_tab: display package ID from the inserted gamecard; fix displayed version numbers from bundled system updates below 3.0.0.

* todo: add notes about creating devoptab devices for HFS/PFS/RomFS file tree dumping.
2023-05-24 21:05:34 +02:00
.github I'm a terrible person and an even worse developer. 2023-05-24 21:05:34 +02:00
code_templates I'm a terrible person and an even worse developer. 2023-05-24 21:05:34 +02:00
host I'm a terrible person and an even worse developer. 2023-05-24 21:05:34 +02:00
include I'm a terrible person and an even worse developer. 2023-05-24 21:05:34 +02:00
libs I'm a terrible person and an even worse developer. 2023-05-24 21:05:34 +02:00
romfs I'm a terrible person and an even worse developer. 2023-05-24 21:05:34 +02:00
source I'm a terrible person and an even worse developer. 2023-05-24 21:05:34 +02:00
.gitignore Support for HOS 16.x changes. 2023-03-29 23:14:21 +02:00
.gitmodules libs: update libusbhsfs. 2022-03-04 13:24:28 +01:00
build.sh Codebase cleanup. 2022-07-05 03:04:28 +02:00
LICENSE.md Change project layout + upgrade license to GPLv3. 2021-03-25 15:26:58 -04:00
Makefile More changes. 2022-07-28 00:53:52 +02:00
README.md Update README.md 2023-03-31 13:29:46 +02:00
todo.txt I'm a terrible person and an even worse developer. 2023-05-24 21:05:34 +02:00

README.md

nxdumptool

Nintendo Switch Dump Tool

Official Discord server: https://discord.gg/SCbbcQx

This branch is used for the development of the ongoing nxdumptool rewrite. Code is highly experimental and lacks a proper UI at this time, but it has been thoroughly tested and should be safe to use. Proof-of-concept (PoC) builds are provided to test different aspects of the codebase.

If a nxdumptool build from the releases page isn't working for whatever you're trying to do (e.g. RomFS dumping), odds are it will work with a PoC build from this particular branch. The old branch will not receive any further updates.

A GitHub workflow is used to automatically build each new commit -- feel free to check it out.

This readme will be updated whenever the rewrite branch is ready for a proper release.

Currently planned changes for this branch include:

  • USB ABI (dump data directly to a PC). ✅
  • USB Mass Storage device support (FAT, NTFS, EXT). ✅
  • Gamecard header dumps. ✅
  • Gamecard CardInfo area dumps. ✅
  • Gamecard InitialData area dumps. ✅
  • Individual NCA dumps (select and dump a specific NCA from a title). ✅
  • Individual NCA FS section dumps (select and dump a specific FS section from a specific NCA belonging to a title, in both extracted and raw image forms) (this includes patched RomFS images). ✅
  • System title support (e.g. dump qlaunch, shared fonts and much, much more at runtime). ✅
  • Better support for NCA BucketTree storages (Indirect, AesCtrEx, Sparse, Compressed), as well as better handling of multi-layered reads in combination with game updates. ✅
  • Volatile ticket dumping -- temporary tickets that are downloaded and kept in RAM instead of being written to the eMMC. ✅
  • Better memory handling while dealing with compressed NRO binaries. ✅
  • Event-driven background threads to manage gamecard insertions/ejections, gamecard application metadata parsing (e.g. the game would be properly identified even if its gamecard has never been used on your console), USB ABI sessions and USB Mass Storage devices. ✅
  • Improved support for multigame gamecards and titles with more than one Program NCA (e.g. SM3DAS). ✅
  • Control.nacp patching while dumping NSPs (lets you patch screenshot, video, user account and HDCP restrictions). ✅
  • Full system update dumps. ❌
  • New UI using a customized borealis fork. ⚠️

Legend:

  • ✅ - Implemented
  • ⚠️ - Partially implemented
  • ❌ - Not implemented