4NXCI-2026 Switch: Difference between revisions
More actions
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 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 [https://github.com/tiliarou/4NXCI 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: | NSP files are organized with descriptive names and proper categorization: | ||
* | * Base Games: <code>GameTitle[TitleID][BASE].nsp</code> | ||
* | * Updates/Patches: <code>GameTitle[TitleID][v65536][UPD].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: | |||
* 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 | ||
== | '''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 | ||
Latest revision as of 06:13, 5 July 2026
| 4NXCI-2026 | |
|---|---|
| General | |
| Author | tetj |
| Type | PC Utilities |
| Version | v1 |
| License | ISC |
| Last Updated | 2026/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:
- Look up the title name from the database using the Title ID
- 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:
keys.datkeys.txtkeys.iniprod.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
- GitHub - https://github.com/tetj/4NXCI-2026