_______ ___________________ __ ____ ____________ .___
\ \ / _____/\______ \ _/ |_ ____ \ \/ /\_ ___ \ | |
/ ! \ \_____ \ | ___/ \ __\/ _ \ \ / / \ \/ | |
/ ! \ / \ | | | | ( (_) ) / \ \ \____| |
\____!__ //_______ / |____| |__| \____/ /___/\ \ \______ /|___|
\/ \/ \_/ \/
-------------------------------------------------------------------------------------
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 ;)