ConvertXciToNsp Switch: Difference between revisions
From GameBrew
More actions
Created page with "{{Infobox Switch Homebrews |title=ConvertXciToNsp |image=Switch-logo.png |description=Convert XCI files to NSP + Rename .NSP files to a standard format. |author=tetj |lastupdated=2026/02/27 |type=PC Utilities |version= |license=N/A |download=https://dlhb.gamebrew.org/switchhomebrews/ConvertXciToNspSwitch.7z |website=https://github.com/tetj/ConvertXciToNsp |source=https://github.com/tetj/ConvertXciToNsp |donation= }} {{#seo: |title=Switch Homebrew PC Tools (PC Utilities)..." |
No edit summary |
||
| Line 19: | Line 19: | ||
|image_alt=ConvertXciToNsp | |image_alt=ConvertXciToNsp | ||
}} | }} | ||
A simple C# console application that batch converts Nintendo Switch XCI files to NSP format using 4nxci. Can also be used to rename NSP files to this format: | |||
* 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> | ||
* | |||
This tool automates the conversion of multiple XCI files to NSP format by processing all <code>.xci</code> files found in a specified folder. | This tool automates the conversion of multiple XCI files to NSP format by processing all <code>.xci</code> files found in a specified folder. | ||
==Prerequisites== | ==User guide== | ||
===Prerequisites=== | |||
[https://github.com/tetj/4NXCI-2026/releases 4nxci.exe] - Must be available in your system PATH or in the same directory as the executable (ConvertXciToNsp.exe). | [https://github.com/tetj/4NXCI-2026/releases 4nxci.exe] - Must be available in your system PATH or in the same directory as the executable (ConvertXciToNsp.exe). | ||
==Usage== | ===Usage=== | ||
Run the application with a folder path containing XCI files: | Run the application with a folder path containing XCI files: | ||
| Line 65: | Line 65: | ||
# Report when all files have been processed | # Report when all files have been processed | ||
==Output== | ===Output=== | ||
The converted NSP files will be created in the same location as the original XCI files. | The converted NSP files will be created in the same location as the original XCI files. | ||
==Performance== | ===Performance=== | ||
* On a hard drive (not SSD), expect approximately 2 minutes to convert a 4GB .xci file | * On a hard drive (not SSD), expect approximately 2 minutes to convert a 4GB .xci file | ||
* Conversion times will vary based on file size and storage speed | * Conversion times will vary based on file size and storage speed | ||
| Line 78: | Line 78: | ||
== External links == | == External links == | ||
* | * GitHub - https://github.com/tetj/ConvertXciToNsp | ||
Latest revision as of 05:06, 22 May 2026
| ConvertXciToNsp | |
|---|---|
 | |
| General | |
| Author | tetj |
| Type | PC Utilities |
| License | N/A |
| Last Updated | 2026/02/27 |
| Links | |
| Download | |
| Website | |
| Source | |
A simple C# console application that batch converts Nintendo Switch XCI files to NSP format using 4nxci. Can also be used to rename NSP files to this format:
- Base Games:
GameTitle[TitleID][BASE].nsp - Updates/Patches'
GameTitle[TitleID][v65536][UPD].nsp - DLC/Add-ons:
GameTitle[TitleID][DLC].nsp
This tool automates the conversion of multiple XCI files to NSP format by processing all .xci files found in a specified folder.
User guide
Prerequisites
4nxci.exe - Must be available in your system PATH or in the same directory as the executable (ConvertXciToNsp.exe).
Usage
Run the application with a folder path containing XCI files:
ConvertXciToNsp.exe <folder_path> [-e] [-d] [-r] [-recursive]
Options
-c: Convert XCI files to .NSP files-d: Delete XCI files after successful conversion-r: Rename NSP files to predefined format:GameTitle[TitleID][BASE].nsp-recursive: Process XCI files in subfolders as well
Examples
Convert XCI files to NSP and delete the original XCI files:
ConvertXciToNsp.exe -c -d "C:\Games\Nintendo Switch\XCI Files"
Convert XCI files to NSP including all subfolders:
ConvertXciToNsp.exe -c -recursive "C:\Games\Nintendo Switch\XCI Files"
Rename NSP files recursively:
ConvertXciToNsp.exe -r -recursive "C:\Games\Nintendo Switch\NSP Files"
The application will:
- Scan the specified folder for all
.xcifiles (and subfolders if-recursiveis specified) - Process each file using
4nxci.exewith the specified options (-c,-d,-r) - Display progress and exit codes for each conversion
- Report when all files have been processed
Output
The converted NSP files will be created in the same location as the original XCI files.
Performance
- On a hard drive (not SSD), expect approximately 2 minutes to convert a 4GB .xci file
- Conversion times will vary based on file size and storage speed
- SSD storage will provide significantly faster conversion times
Changelog
v1.0
- First Release.