NSP-to-XCI-Converter

NSP-to-XCI-Converter copied to clipboard

  _______     ___________________    __           ____  ____________  .___ 
  \      \   /   _____/\______   \ _/  |_  ____   \   \/  /\_   ___ \ |   |
  /   !   \  \_____  \  |     ___/ \   __\/  _ \   \     / /    \  \/ |   |
 /    !    \ /        \ |    |     |  |  (  (_) )  /     \ \     \____|   |
 \____!__  //_______  / |____|     |__|   \____/  /___/\  \ \______  /|___|
         \/         \/                                  \_/        \/      

                     NINTENDO SWITCH NSP TO XCI CONVERTER

============================= BY DAVFAITHID =============================

" POWERED WITH NUT BY BLAWAR " " NSCB BY JULESONTHEROAD " AND LUCA FRAGA'S HACBUILD " VERSION 0.01

Jontheroad's NSCB: https://github.com/julesontheroad/NSC_BUILDER Revised hacbuild : https://github.com/julesontheroad/hacbuild Original hacbuild: https://github.com/LucaFruga/hacbuild Blawar's NUT : https://github.com/blawar/nut SciresM hactool : https://github.com/SciresM/hactool IgorPavlov's 7zip: https://7-zip.org

1. Description

This NSP to XCI converter is based in the awesome function "REMOVE_TITLE_RIGHTS" from NUT by blawar utilized by NSCB and Squirrel by JULESONTHEROAD. This function lets you erase the titlerights encryption from nsp files. Tinfoil and SX installer will install the ticket either way so for it to not stay in your system you need to erase the ticket and cert from the nsp, this batch will take care of that.

WARNING: Piracy Notice

Please do use this tool for piracy. Whether it is sharing converted NSPs, downloading NSPs to convert to XCI, or getting/sharing ROMs, ISOs, Files, XCIs, NSPs, or other such files if it is copyrighted. Remember: PIRACY IS NOT A VICTIMLESS CRIME!

The current version of the program allow you to make multi-content xci or nsp files.

The batch has 2 modes:

• auto mode: you drag nsp files individually or folders with several nsp file Note: auto mode won't process subfolders yet.
• manual mode: you double click the batch and uou can build a list of nsp files to clean, you can even erase items via batch or directly in the list before starting. You can resume the list if you close the window before compleating all the cleanings. It also fetures a check that will stop the cleaning for a file if the titlerights can't be stripped from it. In this case it will generate a log.txt with the file name. If an error is found that file is skipped an the batch continues processing the queue.

2. Important

The program incorporates a custom build of nut.py and hacbuild with several added functions. You won't be able to use it if you replace these files for the official builds.

3. Requirements

• A computer with a Window's OS is needed
• You'll need to have Python 3 installed for the program to work correctly
• You'll need to install these libraries: "urllib3 unidecode tqdm bs4 tqdm requests image" to assist you in this you can run "install_dependencies.bat" file.
• You need to fill the keys_template.txt file inside the ztools folder and rename to keys.txt
• You'll need to have at least .net frameworks 4.5.2 installed so hacbuild can work correctly.

4. Option description

• OPTION 1: Work and Output folders setup
• OPTION 2: Route to needed programs
• OPTION 3: Nut options a) pycommand -> your command to invoke python 3 (by deffault py -3) b) buffer -> buffer in number of bytes for the copy functions
• OPTION 4: Route to game_info.ini and keys.txt
• OPTION 5: REPACK OPTIONS. Controls repack in auto mode. ::Repack option for auto-mode a) xci -> repack as xci b) nsp -> repacck as nsp c) both -> repacck as both ::Type of repack for folders a) indiv -> repack content individually as multiple xci/nsp b) multi -> repack content as single multicontent xci/nsp
• OPTION 6: MANUAL MODE INTRO. a) indiv-> Enter in individual packing mode directly b) multi-> Enter in multi-pack mode directly c) choose-> Prompt to choose the mode in which you want to enter ::OPTION 7: ZIP FILES -> Select if you want to zip things that will allow to restore nsp files to original state.

5. Limitations

• You can't make multi-content xci files with more than 8 games. It'll give error when loading in horizon. I suspect it may be a qlauncher limitation so it could work with theme mods but INTRO didn't test it.
• If you pack an update that requires a superior firmware that you're in you won't be able to skip the update prompt.

6. Planned features

• List manager.
• Batch tools to put in application some of my changes to nut libraries.
• Support for meta patching and control nca building for custom logos.
• Skips for individual mode.
• Content splitter.
• Titlerights restoration mode.

7. Thanks and credits to

This converter is based on

a.) Nut: Without the work of "blawar" one of the most talented Switch sceners nothing of this would be possible at this point. https://github.com/blawar/nut b.) Hacbuild: The xci repacking functions are based in hacbuild made by LucaFraga Original hacbuild: https://github.com/LucaFraga/hacbuild) by LucaFraga Revised hacbuild by JULESONTHEROAD: https://github.com/julesontheroad/hacbuild c.) hactool: Program which function is give information, decrypt and extract a lot of different kind of files us by the NX System. Hactool was made by SciresM https://github.com/SciresM/hactool d.) 7zip: Program meant to compress and extract files in several formats 7zip was made by Igor Pavlov https://www.7-zip.org/ e.) NSCB: https://github.com/julesontheroad/NSC_BUILDER

Thx to MadScript77 his great suggestions,specially the idea of profiles for the batch. Thx to Liam from old SH discord for always being helpfull. Thx to XCI-Explorer's creator StudentBlake since his program made easier for JULESONTHEROAD to came up with the fix for hacbuild errors.

Also thanks to all members from gbatemp, elotrolado.net and my friends at discord ;)