4NXCI Switch

From GameBrew
4NXCI
4nxcinx.png
General
AuthorThe-4n
TypePC Utilities
Version4.03
LicenseISC
Last Updated2019/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

4nxcinx.png

4nxcinx2.png

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

Advertising: