welcome: please sign in
location: SoftwarePC_en

PC Software

NVC - a tool for organizing files on SD cards for SIO2SD

Working with a huge amount of files can be problematic even with a fast PC. You can help yourself by setting a directory structure. A similar problem we have when we want to put ATARI games, demos and applications on an SD card and later search with SIO2SD for a specific title (either with keys or with the Configurator). This is especially useful if there are more than 12 thousands titles on the card (so many games you will find in the archive available at http://www.atarionline.pl). Last but not least - SIO2SD does not sort files alphabetically (they are displayed in the order they were copied).

Since the Version 3.0 of the SIO2SD Software, the Configurator supports file searching. If you know a file name (or its part), you can enter the search mask and the device will search the complete SD card and present you the results. Regardless if you use the search feature or not, it is still a good idea to organize your files in directories. NVC will do the job for you.

About the tool

NVC stands for "Next Valid Character". It is a feature of car navigation systems to speed up entering destination address. When you want to enter address, the system shows you a virtual keyboard, where only these letters are selectable, which match entries from the database. If you travel to London, then after entering the first 'L' letter, it will be greyed out, because there is no city which name starts with "Ll". But there will be other letters selectable: 'a' (Lancaster), 'e' (Leeds), 'o' (London), etc.
NVC takes advantage of a similar idea. Its goal is to copy files to the SD card while creating directory structure at the same time. This structure can be easily illustrated through an example:

While copying the MOON PATROL (V1).XEX file, the tool will create directories M/MO/MOO, and copy the file to the MOO directory. The depth of nesting (whether M/MO is fine, or maybe M/MO/MOO/MOON would be better, etc.) is configurable.

Files/nvc03.jpg

If an SD card is empty and we are going to use NVC to populate it with games, then we get an additional bonus:

The NVC tool can be used as well to search for files that got lost somewhere. It is enough to specify the entire drive as an input directory, and NVC will find all files with given suffixes and copy them to the output directory.

The VIDEOS below show loading of the Draconus game from an SD card prepared with NVC tool:
SIO2SD controlled with keys
SIO2SD controlled with the Configurator

Download

nvc.zip (78 KB)

NVC is written in JAVA. In order to run it, you will need a JAVA virtual machine.
An installation is not required. After unzipping NVC.zip you will get:

NVC Usage

Double click the nvc.jar file to start the tool. A new window will appear:

Files/nvc01.jpg

If started first time, the tool shows default settings, otherwise it shows the last used settings.

Settings description:

Upon clicking on the Start button, the tool searches the Input directory (and all its subdirectories) for files matching given suffixes. It maintains a list containing search results, which is sorted alphabetically after the search is done. NVC follows that list to copy files to the Output directory:

Files/nvc02.jpg

While copying files, NVC creates subdirectories according to the "Max output directory structure depth" and "Force directory creation at the specified depth" settings. If there are files with identical names found, their content will be compared. Identical content means only one copy in the Output directory. If the files are different, all will be copied and the name of every file that follows will be extended with NVCVERX, where X is a counter.

NVC Usage from a command line

NVC can be started alternatively from a command line.

java -jar nvc.jar -i INPUT -o OUTPUT [-f -l LEVEL] suffix1 [suffix2 ... suffixn]
 -f        : force directory creation for files with unique names, default: false
 -i INPUT  : input directory
 -l DEPTH  : output directory depth, default: 3
 -o OUTPUT : output directory
 suffix    : list of suffixes, example: atr com xex xfd

Examples:

java -jar nvc.jar

performs the same action as double-clicking the nvc.jar (you may need it if double-clicking the nvc.jar does not work in your java environment)

java -jar nvc.jar -i input_dir -o output_dir -l 2 atr

search "input_dir" and its subdirectories for files matching "atr" suffix and copy them to "output_dir", while creating a directory structure with up to 2 levels of subdirectories

java -jar nvc.jar -i C:\ -o d:\ATARI -f -l 3 atr xfd xex

search the complete "C" drive for files with "atr", "xfd" and "xex" suffixes and copy them to the "ATARI" directory on the "D" drive, while creating a directory structure with exactly 3 levels of subdirectories

Remarks

DriveSort - a tool for sorting files and directories

DriveSort sorts files and directories alphabetically on memory cards formatted as FAT volumes. More information on the projeckt site.

Download

DriveSort (version for Windows)

SoftwarePC_en (last edited 2013-03-18 17:09:37 by Montezuma)