Helix Icon Arranger v1.2 by Matthew Strange
©2001-2004 Autograph Systems
Support: matt@autsys.com
Price: $10.00 (Credit Card purchases only)
Purchase Helix Icon Arranger

Bonus! Purchase Helix Icon Arranger and get the Helix Version Checker free!

Helix Icon Arranger is a simple utility program (actually an AppleScript) that brings the icons in a Helix relation (and the main collection window) back into the center of the icon field. Drag a collection onto the utility and select the relations that you want to gather.

Helix Icon Arranger works with Helix collections that are compatible with Helix versions 4.5.0 through 5.3. Helix Icon Arranger has been tested with Mac OS 9.0­9.2.2. Mac OS X support is planned once Helix itself is Mac OS X compatible.

Installation: No special installation is required for Helix Icon Arranger, but it requires the "Extract Resource" scripting addition. Extract Resource is freeware, but distribution is limited by the author, Gregory T Quinn. If you do not have a copy of the GTQ Scripting Library, you can download it from the Osaxen website. To install the scripting addition, just drag it onto your System Folder (or follow the instructions included with that package).

Operation of the utility is pretty straightforward, but for those of you who like step by step instructions, here they are.

After making a backup copy of your collection (just in case) double click Helix Icon arranger (or drag your collection onto it). A dialog will appear welcoming you.

After a few seconds, a second dialog will appear letting you know that the preliminary work is done and that the search for relation data is about to begin...

Next, Helix Icon Arranger will ask you which mode you want to put the windows into...

"Leave Unchanged" is the default, but it is recommended that if you are having problems with a collection, you put all of the windows into "View by Icon" mode. There is a rare bug in Helix that results in an internal table getting corrupted and causing Helix to crash with "Error Code 0305." Putting a window into View by Icon mode corrects the problem, so it is generally a good idea to put the collection and relation windows into View by Icon mode from time to time.

Next,the utility searches the collection, looking for the internal tables that store the collection and relation icon positions. The main collection table will be found first, and when it is, a dialog will appear briefly...

After the main collection table is found, the relation tables are seached out. As each one is found, the status dialog briefly appears, letting you know that it's still working, and how many relations have been found so far...

Although you have an option to stop after each internal table is found, you have to be quick if you actually want to stop the process: the dialogs self-dismiss in one second. (Remember, they are presented primarily for feedback so that you will know that the program is still working.)

Note that when the relations are being searched for, the dialogs report the number of relations found and the total number of relations Icon Arranger is looking for. Occasionally the total number of relations is higher than the actual number of relations in the collection. I don't know why this happens, but I suspect the higher number includes relations that once existed, but have been deleted from the collection. (The total relation count is taken from a statistical resource that is unrelated to the actual data.)

When the entire collection has been searched, a new dialog appears providing some statistics, the relation names, and how many icons each has...

Select the collection and relations you want to arrange the icons for by clicking, shift-clicking, and command-clicking. (Shift-clicking selects a contiguous section, command-clicking selects multiple lines one by one.) After you select the items you want to arrange, click OK. The real work begins at last.

As each relation is completed, a dialog will briefly appear to inform you as each relation is done.

And after all relations are done (or you click Stop) the final dialog informs you that the process is done and reminding you to run the collection through Update Collection before using it.


Additional notes

Drag and Drop supports multiple files. If you drag more than one collection onto Helix Icon Arranger, the files will be processed in sequence.

Version History

Nov, 2001: v1.0: Initial release, supports Helix 5.0­5.0.2.

Jan, 2002: v1.1: Added support for Helix 4.5.0-4.5.5.
Reports the name of each relation as it is located.
Added total relation count ('x of y') as each is located.
Performance improvements.
Code clean up.

Aug, 2003: v1.1.1 Added support for versions through 5.2.1

Feb, 2004: v1.2 Added support for versions through 5.3