Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

4NXCI-2026 Switch: Difference between revisions

From GameBrew
Created page with "{{Infobox Switch Homebrews |title=4NXCI-2026 |image=Switch-logo.png |description=A PC utility to convert XCI files to NSP and rename NSP/NSW files to a standard format. |author=tetj |lastupdated=2026/02/27 |type=PC Utilities |version=v1 |license=ISC |download=https://dlhb.gamebrew.org/switchhomebrews/4NXCI2026Switch.7z |website=https://github.com/tetj/4NXCI-2026 |source=https://github.com/tetj/4NXCI-2026 |donation= }} {{#seo: |title=Switch Homebrew PC Tools (PC Utilities..."
 
No edit summary
 
Line 19: Line 19:
|image_alt=4NXCI-2026
|image_alt=4NXCI-2026
}}
}}
'''4NXCI-2026''' is based on the work of [https://github.com/tiliarou/4NXCI 4NXCI] by The-4n. It is a modernized version for Visual Studio 2026 with performance improvements and updated dependencies.
4NXCI-2026 is a PC utility to convert XCI files to NSP and rename NSP/NSW files to a standard format.


This tool processes individual XCI files. To process an entire folder of XCI files, [https://github.com/tetj/ConvertXciToNsp ConvertXciToNsp] provides batch processing functionality.
The project is based on the work of [https://github.com/tiliarou/4NXCI 4NXCI] by The-4n. A modernized version for Visual Studio 2026 with performance improvements and updated dependencies.
 
'''Enhanced File Naming Format'''


NSP files are organized with descriptive names and proper categorization:
NSP files are organized with descriptive names and proper categorization:
* '''Base Games''': <code>GameTitle[TitleID][BASE].nsp</code>
* Base Games: <code>GameTitle[TitleID][BASE].nsp</code>
* '''Updates/Patches''': <code>GameTitle[TitleID][v65536][UPD].nsp</code>
* Updates/Patches: <code>GameTitle[TitleID][v65536][UPD].nsp</code>
* '''DLC/Add-ons''': <code>GameTitle[TitleID][DLC].nsp</code>
* DLC/Add-ons: <code>GameTitle[TitleID][DLC].nsp</code>


All NSP files are automatically organized into a folder named after the game title. The source XCI file is kept by default unless the <code>-d</code> flag is specified.
All NSP files are automatically organized into a folder named after the game title. The source XCI file is kept by default unless the <code>-d</code> flag is specified.
Line 42: Line 40:
</pre>
</pre>


'''Performance Enhancements'''
Performance Enhancements:
* Multi-threaded processing for applications, patches, and add-ons
* Multi-threaded processing for applications, patches, and add-ons
* Optimized file I/O with 16MB buffering for XCI files
* Optimized file I/O with 16MB buffering for XCI files
* Parallel extraction when multiple CPU cores are available
* Parallel extraction when multiple CPU cores are available


== Installation ==
'''Note:''' This tool processes individual XCI files. To process an entire folder of XCI files, [https://github.com/tetj/ConvertXciToNsp ConvertXciToNsp] provides batch processing functionality.
 
== User guide ==
'''Recommended usage (2026):'''
'''Recommended usage (2026):'''
<pre>
<pre>
Line 110: Line 110:


== External links ==
== External links ==
* Github - https://github.com/tetj/4NXCI-2026
* GitHub - https://github.com/tetj/4NXCI-2026

Latest revision as of 06:13, 5 July 2026

4NXCI-2026
General
Authortetj
TypePC Utilities
Versionv1
LicenseISC
Last Updated2026/02/27
Links
Download
Website
Source

4NXCI-2026 is a PC utility to convert XCI files to NSP and rename NSP/NSW files to a standard format.

The project is based on the work of 4NXCI by The-4n. A modernized version for Visual Studio 2026 with performance improvements and updated dependencies.

NSP files are organized with descriptive names and proper categorization:

  • Base Games: GameTitle[TitleID][BASE].nsp
  • Updates/Patches: GameTitle[TitleID][v65536][UPD].nsp
  • DLC/Add-ons: GameTitle[TitleID][DLC].nsp

All NSP files are automatically organized into a folder named after the game title. The source XCI file is kept by default unless the -d flag is specified.

Example folder structure:

4nxci.exe -c "The Legend of Zelda BOTW.xci"

The Legend of Zelda - Breath of the Wild/
├── The Legend of Zelda - Breath of the Wild[01007EF00011E000][BASE].nsp
├── The Legend of Zelda - Breath of the Wild[01007EF00011E000][v196608][UPD].nsp
└── The Legend of Zelda - Breath of the Wild[01007EF00011E000][DLC].nsp

Performance Enhancements:

  • Multi-threaded processing for applications, patches, and add-ons
  • Optimized file I/O with 16MB buffering for XCI files
  • Parallel extraction when multiple CPU cores are available

Note: This tool processes individual XCI files. To process an entire folder of XCI files, ConvertXciToNsp provides batch processing functionality.

User guide

Recommended usage (2026):

.\4nxci.exe -c <path_to_file.xci>

Add -d to delete the source XCI file after conversion:

.\4nxci.exe -c -d <path_to_file.xci>

Rename existing NSP/NSZ files:

.\4nxci.exe -r <path_to_file.nsp>
.\4nxci.exe -r <path_to_file.nsz>

This will rename the NSP or NSZ file to match the naming format based on its internal metadata (Title ID, version, type). The original extension is preserved in the output filename.

Title name database:

The tool relies on US.en.json (blawar's titledb) to resolve Title IDs to game names. It is automatically downloaded (~77 MB) the first time -r is used, and refreshed automatically when the local copy is older than 7 days.

The tool will automatically:

  1. Look up the title name from the database using the Title ID
  2. Fall back to using the Title ID if not found (e.g., Japan-exclusive titles, homebrew, unofficial releases)

When falling back, the Title ID is used as the name instead:

010044901C5C2000[010044901C5C2000][BASE].nsp

Full command syntax (LEGACY/DEPRECATED):

.\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
-e, --extract            Use Titlename instead of Titleid in nsp name
-d, --delete             Delete source XCI file after successful conversion
--keepncaid              Keep current ncas ids

Required Keys:

The tool will automatically search for key files in this order:

  1. keys.dat
  2. keys.txt
  3. keys.ini
  4. prod.keys (recommended - standard output from lockpick_rcm)

Place one of these key files in the same directory as the executable, or specify a custom path with the -k option.

You can obtain prod.keys from your Nintendo Switch using Lockpick_RCM.

Changelog

v1.0

  • First Release.

External links

Advertising: