.ionEngine help v. 1.6


.ionEngine home page online



Overview

.ionEngine is intended to assist power downloaders with the very important, all-consuming task of sorting all their binaries. This task is especially daunting if you have high bandwidth and lots of hard disk space. .ionEngine works especially well with Newsbin, which is an excellent shareware newsreader.

If you don't use newsbin or another program that saves descript.ion files, just make sure to download the .sfv, .csv,.par, and .m3u files along with your binaries. Then .ionEngine can still help you sift through large numbers of files quickly to decide what to keep, what to trash and what to put on CD.


Supported File Types

.ionEngine makes use of 5 standard file types to gather information about your files:

descript.ion files

.sfv files and .csv files .par , .p0*, .p1* files .par2 files .m3u files other file list formats

Version Info

This is version 1.6 of .ionEngine. If you have any trouble installing, or find any bugs, please email me at so I can fix it. Tell me your windows version, the version of .ionEngine, exactly what happened, and if it can be duplicated.

Registration

ionEngine is shareware and costs $10.
Although this version of the program is not crippled or limited it does have a very annoying nag screen.
Registered users are registered for all future versions as well.

To register, click below (you must be online).
Be sure to enter a valid email address as it is required to receive your registration key.
Quietsites will not use your email address for any other purpose or give it to anyone else.


Usage

If you have allowed .ionEngine to register itself as the default program for filetype .ion, just double-click on a descript.ion file in windows explorer. .ionEngine will launch and load that directory into the main grid.

All the subject lines from the descript.ion file and any .sfv, .csv, .par, .pxx, .m3u, files will be read, so that all files in the directory will be represented in the grid. Any files not represented in a file-list or in the descript.ion file will be labelled "__Orphan__"

Once the grid is loaded, you have the option to do a number of different file-related tasks. The main program functions are "Auto Move", "Power Move", "Move Selection", "Move Selection to Subdirectory", "Consolidate Subdirectories" and "Delete Selection". All of these functions except Auto-Move and Consolidate operate on the currently selected files in the main grid. Automove works on the entire directory, but not on any subdirectories. Consolidate operates on the selected directory and all of its subdirectories.

There are probably lots of effective ways to use this program, but here is what I do:

    Power Move
Power move allows you to move groups of related files into multiple directories, based on similarities in their filename, or the subject line. You have to first select a range of related files that have text that you want included in the directory names in the same character positions of either their filenames or the subject lines. For instance, the following list would be an excellent candidate to sort using Power-move:
   MyScan_number_001_page_00Cover.jpg
   MyScan_number_001_page_01.jpg
   MyScan_number_001_page_02.jpg
   MyScan_number_001_page_03.jpg
   MyScan_number_002_page_00Cover.jpg
   MyScan_number_002_page_01.jpg
   MyScan_number_002_page_02.jpg
   MyScan_number_002_page_03.jpg

Once you have selected a good range of files and clicked Power-Move, you'll be able to create a directory path pattern by selecting ranges of columns. You can also add extra slashes for nested subdirectories and plain text.

In the example above, I would select the first bolded range ("MyScan"), then add a slash, then select the second bold range ("001"). The result would be to move the first 3 files into "MyScan\001" and the next 3 files into "MyScan\002". (The directories will be created if they don't already exist.)

If you want to get fancy, you can also add plain text to the path pattern, so for instance you could type in "MyCategory" first, add a slash and then do the same thing as before. The result would be files moving into "MyCategory\MyScan\001" and "MyCategory\MyScan\002".
    Move
There are two ways to move sets of files into their own directories. "Move Selection To..." brings up a directory selection window, but if you want to move files into a subdirectory of the current directory, just type in the name of the subdirectory into the little text box and click "Move Selection to Subdir:" or hit enter. This is a very quick way to move a lot of files into multiple directories.
    Consolidate
Consolidate subdirectories takes all files in all the subdirectories of the selected directory and moves them up to the selected directory. Descript.ion file records are also moved.

This function is helpful if, for example you have downloaded similar types of files from several newsgroups. Newsbin sends them to separate directories for each newsgroup, but since they are all related, you may want to sort them all together. If you consolidate all the subdirectories, you can then work on a larger list of all your downloaded files at once.

Consolidate is also helpful if you need to reverse an Auto-Move in order to try different settings.

    Delete
The Delete function deletes all selected files. Because the recycle bin is very slow, you can optionally select "Permanent Delete" which bypasses the recycle bin.
    Auto-Move
Auto-Move is a highly configurable function that analyses all files in the directory, in order to group related files together and move them into intelligently named subdirectories.

Auto-Move uses the subject lines, the filenames and the other file lists (.csv, .sfv, .par, .m3u) to determine which files are related. To create the names of the directories, a configurable rule-based macro capability is included. This allows advanced users to filter out meaningless or irrelevant substrings in the subject lines. A default set of macro rules is included.

In addition, after the information has been analyzed, you have the option to edit the subdirectory names that will be created. This is done on the "Preview Results" form, using several commands including "Replace","Merge / Rename", and "Slice and Dice".
"Slice And Dice" is the most interesting of these and allows you to very quickly change lots of directory names.

    Auto-Move Configuration:
    Eliminate Re:
    (Recommended) Removes "Re:" from the beginning of subject lines so that related lines sort together.
    Treat - _ ~ ` = As Word Boundary Characters
    (Recommended) This option makes most subsequent text manipulations more effective.
    Eliminate Number Related Substrings
    Patterns like "File 44 of 56", "Page 1/10", and "570 KBytes" can be removed so that they are not included in the directory names that are created. In version 2, I plan to make these configurable.
    For those who are interested, the regex patterns applied are:
    (file|files)?( |#)*(\(|\[|<) *\d+ *- *\d+ *(\)|\]|>)?
    (file|files)?( |#)*(\(|\[|<)? *\d+ *(\)|\]|>)? *(of|\\|/) *(\(|\[|<)? *\d+ *(\)|\]|>)?
    (file|files)?( |#)*(\(|\[|<)? *\d+ *(\)|\]|>)? +o' +(\(|\[|<)? *\d+ *(\)|\]|>)?
    \d *(file|files)
    (file|files) *\d
    \d+(.\d+)? *(pgs|pg|pages)
    (pg|pgs|pages)\d+
    \d+(.\d+)? *(dpi|kbytes|bytes|kb)
    Use File Name instead of Subject Line
    Directory names will be based on the filenames rather than on the subject lines. All the rules in the rule box will be applied to filenames instead of subject lines. I rarely find this option necessary, especially now that Auto-Move is applied to filegroups only.
    Accuracy In Merging Similar Subjects

      Only Auto-Move Files with File lists. (Highly Recommended) Unless there is a great outcry from users, the next version of .ionEngine will only allow auto-move on files with file-lists. This and the following option will disappear. Let me know if this won't work for you! I am making this change because I found that there were too many false positive matches otherwise. In other words groups of files were being lumped together that were not related. With this new setting selected that should never happen.

      Percentage of subject line that must match. If the option above is not selected, then .ionEngine will attempt to intelligently figure out related files based on similarities in the subject line. See above.
    Rules
    The user configurable rules are one of the most powerful parts of the program. By default a set of rules is in place that has good general utility for a diverse set of newsgroups.
    Details
    Spaces
    All spaces in the resulting subject line can optionally be replaced by underscores or eliminated and replaced by a capitalized start-of-next-word.
    Auto-Move Preview Results:

After Auto-Move has done its best at figuring out the directories to create and the files to put in them, you have a chance to change everything around, cancel it altogether, or proceed. Most likely you will want to do some clean up work on the directory names Auto-Move has come up with, and there are several powerful commands available for you in the Preview Results page. One very useful feature available in all these commands is the ability to add nested subdirectories, just by adding a \ wherever you want it in the text.

  • Slice And Dice Selected Directory Names
    Displays a new window with a grid of the selected subdirectories. In this window you can select rectangular or vertical selections and delete them, replace them with other text, or add nested subdirectories.
    This command is particularly useful for removing large amounts of text from the subject lines that is all of the same length but varies a little in content.
    This is the most useful of the commands as it allows you to very quickly change a large number of directories to exactly what you want.
  • Merge / Rename
    Select one or more subdirectories and set a new name. If you select more than one subdirectory, they will be merged into the new name that you specify. This is a simple and useful function for cases where Auto-Move has been too picky and split what should have been a single directory into more than one.
  • Replace Text In Selection
    Select one or more subdirectories and alter the names of each of them with standard and regex replace commands.
  • View Files
    Pops up a list of all the files that will be moved to the selected subdirectories
  • Remove
    Removes all the files for the selected target directories and does not create those directories. The files will remain in the root directory.


Shell Integration

There are two main methods of integrating .ionEngine into the windows shell. The most powerful is "Associate .ion files with this program", available from the "preferences" menu. This creates a file type for .ion files, associates .ionEngine with those files, and adds an icon to the file type. This allows you to double-click on descript.ion files in windows explorer to open the program. Also available is "Create 'Send To' Shortcut". (This option may not work depending on your system. If not, you can create a shortcut to the program manually and move it to your send-to directory.) A "send to" shortcut allows you to right-click on any file in the directory and "send" it to .ionEngine. You can send any type of file to .ionEngine, not just descript.ion files.

Regular Expressions

Regular Expressions are used in the Auto-Move function to allow users to control the names of the subdirectories that are created. The regex library implented is Microsoft's VBScript Regular Expressions 5.5. Complete documentation is available at MSDN. A summary is available here

Tips


Known Issues

Known Issues

Version History

1.6 Minor Upgrade

1.5 Semi-Major Upgrade

1.0 first official release
0.9.85 bug fix release
0.9.64 first public release

Contact: Bug Reports, Feature Requests, Support

Feel Free to contact me for any reason except to spam me! dev@quietsites.com