XCIment Switch

XCIment
General
Author	WolfThatGoesMoo
Type	Game Management
Version	1.1
License	Mixed
Last Updated	2018/06/26
Links
Download
Website
Source

Nintendo Switch cartridge (.xci file(s)) auto-renaming tool. It's used for the processing of .xci files using internal header data to rename files appropriately.

Note: This program triggers flags within anti-virus scans and could be considered dangerous. If this worries you please do not use this tool.

Features

• Batch processing of .xci files using internal header data (defaults with Fast Mode, see Additional Information below).
• Settings file for quick re-use.
• Also handles individual files easily.
• Support for cart2 files.

User guide

Note: Please always have backups of your files before using this tool.

How to use:

1. Have a directory/folder prepared with only .xci files in it (Has not been tested yet with a folder that has something else in it)
2. Open XCIment and click the top center button and navigate to the folder containing the files you want renamed.
3. Each file will automatically be selected, prepared for renaming. To exclude files from being renamed, just unchecked them.
4. Click proceed, and they will automatically be renamed.

Optional:

• To handle another directory with .xci files, simply click cancel, then repeat steps 2-4.
• You can click settings to make changes to how files are renamed.

Additional Information:

• Fast Mode (...) will rename files based off of a scene name rather than looking up internal header information first.
• Significantly faster, but less accurate. (NOTE: Requires internet for Fast Mode. This downloads a copy of nswdb's xml file.)

Screenshots

Changelog

Version 1.2 (Pending Release)

• Improvement: Add more logic checks to see if a given file is already correctly named, and skip processing if it if is. (This is make it run significantly faster and lets you update a folder as you get more .xci files instead of renaming them all over again.) [Working on it..]
• Improvement: Check for duplicate file names that start from different original names (different regions have same internal name from the header, and results in naming conflict if you own the same game in different regions) [Done]
• Improvement: Found a better method for reading header files. Significantly faster and supports cart2 files. [Done]
• Improvement: Publishing source code to github. [Working on it..]
• New Feature: Support for appending attributes to file names. (Request) [Done]
• New Feature: Support for finding .xci files within sub-directories (Request) [Done]
• New Feature: Support for directory creation for each file, so the .xci file is stored within its own sub folder. e.g. : /This Is The Police/This Is The Police.xci (Request) [Done]
• New Feature: Add ability to sort the files by the three main columns (Alphabetically, reverse alphabetically, and by status) [Working on it..]
• New Feature: Support for drag & drop of folders containing .xci's and single .xci's onto the main window to be processed [Working on it..]
• New Feature: Adding a settings option that replaces "Fast Mode" on the interface. Fast Mode will be a setting within a new window. This allows more options to be implemented and organized. [Done]
• New Feature: Add "Undo" feature to reverse the rename of a selected item or all items (In case there was an error....this is mostly for me) [Working on it..]
• New Feature: XCI Validity Checker. Check to make sure the files you're working with are valid and complete! (What?...you got it from some where sketchy?...well feel safe knowing!) [Done]
• New Feature: Support for cart2 files [Done]
• New Feature: Error handling with a flagging system to graphically show users a failed rename: [Done]

Version 1.1

• Improvement: Each file is deselected as it's renamed and removed from the list [Done]
• Improvement: Cancel button text has changed to "Finish" after the renaming process has finished [Done]
• Improvement: Removed final prompt showing how many files were renamed. It was inaccurate (fixed) and has been moved to the status bar on the bottom instead. [Done]
• Improvement: Status will now reflect a file that is already named correctly and skip it [Done]
• Improvement: Increased width of status and status label to show full strings [Done]
• Improvement: Added a time out function if a process stalls [Done]
• Improvement: General over haul and refactoring of code. [Done]
• Improvement: Added 250+ lines of debugging and error handling. [Done]
• Bug Fix: The cancel button didn't stop it from renaming files lol fixed that #CriticalInterruptProcess [Done]
• Bug Fix: Proceed button was being re-enabled after renaming all files, which caused errors [Done]
• Bug Fix: Deselect/Select All button not being disabled after renaming process. Caused glitches [Done]
• Bug Fix: 30+ game title name errors including those mentioned by Drejj and Znuf. Now have dedicated string check logic and files are being named correctly now. Thanks guys! [Done]
• Bug Fix: blank .xci files are a thing of the past! [Done]

Version 1.0

• Released [Done]

Credits

• SciresM: His work on hactool is used in this program to extract the title of a given .xci.
• : For dumping the required keys used to decrypting the .xci files.
• c80: For providing insight to the structure layout of a .xci file.
• Drejj, Znuf: Bug discoveries.

External links

• GBAtemp - https://gbatemp.net/threads/xciment-auto-xci-file-renaming-tool.506348/
• GitHub - https://github.com/WolfThatGoesMoo/XCIment