4NXCI Switch

4NXCI
General
Author	The-4n
Type	PC Utilities
Version	4.03
License	ISC
Last Updated	2019/04/22
Links
Download
Website
Source

4NXCI is a tool for converting XCI (NX Card Image) files to NSP.

4NXCI is based on hactool by SciresM.

User guide

You should load your keyset file with -k or --keyset option followed by a path to it or place your keyset file with "keys.dat" filename in the same folder as 4NXCI. Required keys are:

Key Name	Description
header_key	NCA Header Key
key_area_key_application_xx	Application key area encryption keys

By defaullt, Created NSP files are located in the same folder as 4NXCI with 'titleid.nsp' filename.

You can change output directory with -o, --outdir option and use titlename for filenames with -r, --rename option.

4NXCI creates "4nxci_extracted_xci" folder as a temp directory, It deletes the directory content before and after conversion.

If you use -t, --tempdir option to choose a temporary directory, Make sure it's an empty directory and it's not the same as output directory otherwise 4NXCI deletes it.

Usage

*nix: ./4nxci [options...] <path_to_file.xci>  
Windows: .\4nxci.exe [options...] <path_to_file.xci>  
  
Options:  
-k, --keyset             Set keyset filepath, default filepath is ./keys.dat  
-h, --help               Display usage  
-t, --tempdir            Set temporary directory path  
-o, --outdir             Set output directory path  
-r, --rename             Use Titlename instead of Titleid in nsp name  
--keepncaid              Keep current ncas ids  

Screenshots

Changelog

v4.03 2019/04/22

• Fixed a bug in file path.

v4.02 2019/04/11

• Added support for keygeneration 8 (Firmware 7.0.0+).

v4.01 2019/04/01

• Fixed a bug cause broken nsps when using --keepncaid option.
• Fixed a minor bug in opening XCI with long filepath.

v4.00 2019/03/12

• 4NXCI now patches acid public key and signs nca header (signature 2).
• Enhanced NPDM patching.
• Removed key warning message.
• Fixed a bug cause loading a file with empty filepath when keyset file is not specified.

v3.06 2019/02/05

• Added keys.txt, keys.ini and prod.keys as default locations for loading keyset file.
• Removed stdout and stderr buffer.
• 4NXCI-GUI:
  • Added checkbox to allow setting temporary folder equal to output.
  • Auto set key filepath if it's located in program's directory.
  • Modified convert button to prevent launching multiple instances of 4NXCI in background.
  • Fixed log sync.
  • 4NXCI-GUI changes credits: https://github.com/TehPsychedelic

v3.05 2019/02/01

• Fixed support for XCIs with non-title crypto updates (Custom XCIs).
• Fixed a bug cause temp folder doesn't get deleted after conversion is done when xci contains update.
• 4NXCI-GUI:
  • Removed read only from xci, output and keys fields.
  • Used tabIndex property to allow proper tab browsing in order.
  • Set output folder equal to folder where XCI is located. If an output folder was selected previously, doesn't change anything.
  • Browse dialog for output folder now automatically selects the folder in text field, if set.
  • 4NXCI-GUI changes credits: https://github.com/TehPsychedelic

v3.01 2019/01/29

• 4NXCI now escapes special file path characters in titlename.

v3.00 2019/01/24

• Added 4NXCI-GUI
• Added --rename option for using titlename instead of titleid for naming nsps.
• Added --keepncaid option for keeping original nca ids in cnmt.
• 4NXCI now only looks for section 0 in program nca for main.npdm.
• Removed dummy tik and cert option.

v2.10 2018/12/03

• Added support for keygeneration 7.
• Added options for setting temp and output directory paths.
• Added support for gamecards with multiple updates.

v2.01 2018/11/14

• Fixed a bug cause metadata ncas remain open in 4NXCI and removing temp directory fails.

v2.00 2018/11/01

• 4NXCI now supports XCIs with more than one Application Metadata (Gamecards with more than one game).

v1.36 2018/10/23

• 4NXCI now delete temp folder after the conversion is finished.
• Changed cnmt patching method.
• Fixed a bug cause invalid RequiredSystemVersion value in patch cnmt.xml.

v1.35 2018/09/23

• 4NXCI no longer creates dummy tik and cert by default.

v1.30 2018/09/10

• Added Options.
• Added option for skipping dummy cert and tik creation.
• Added option for manually loading keyset file.
• Removed rightsid calculation for NCA Metadatas.

v1.21 2018/09/01

• Fixed a bug cause crash when converting gamecards with 1 dlc.

v1.20 2018/08/30

• Added support for gamecards with more than one dlc.
• Fixed a bug cause wrong keygeneration value in xml metadata.

v1.10 2018/08/25

• Added cert and tik packing for download type cnmts.
• Fixed a bug cause random meta id and hash values in xml metadata.
• Fixed a bug cause random metadata nca filename in created nsp.
• Changed dummy tik titleid.

v1.00 2018/08/23

• Increased conversion speed (buffer size is now 100MB).
• Modified most parts of dummy cert.
• Minor console output changes.
• Improved stability.

v0.9-Beta 2 2018/08/18

• Improved stability.

v0.9-Beta 1 2018/08/18

• Added support for all xcis.
• Added dynamic nsp creation based on metadata.
• Fixed a bug which cause program crash and bad nsps due to program nca hash miscalculation.
• Improved stability.

v0.9-Alpha 5 2018/08/13

• Added support for current sig patches.
• Enhanced meta nca creation.

v0.9-Alpha 4 2019/08/07

• Added meta nca encryption (for supporting all nsp installers).

v0.9-Alpha 3 2018/08/07

• 4NXCI now rebuilds meta nca.
• Fixed xml meta line breaker bug.

v0.9-Alpha 2 2018/08/05

• Fixed large file support problem in 32-bit builds.

v0.9-Alpha 1 2018/08/03

• Initial Release.

Credits

Thanks: SciresM, Rajkosto, Switch Brew.

Thanks TehPsychedelic for working on 4NXCI-GUI.

External links

• GitHub - https://github.com/The-4n/4NXCI