Customising a Mac OS X Installation

This section applies if you installed Jim on a Macintosh computer running OS X 10.5 or later. It describes how to tailor the installation if the programme will not start, if you wish to improve the performance of Jim, or if you want to run Jim's stand-alone tools in batch (text-only) mode.

If you installed to the default location, the install folder will be /Applications/Xinapse/Jim5. Open a terminal window and change directory to the install folder:
cd /Applications/Xinapse/Jim5
In the installation folder you'll find various application folders, such as the one for the main Jim application (Jim.app). There is one application folder for each the applications in the Jim suite.

To customise the behaviour of one particular application, in the example, Jim change directory into the application's Contents folder:
cd Jim.app/Contents
In that folder you will find a file called Info.plist. You can edit that file using your favourite text editor. Inside the Info.plist file you'll see a line like:

<string>-Dlicense.filename=license.txt -Xms16m -Xmx1024m </string>

You may wish to can change this line, for example:

If you receive messages from Jim that it does not have enough memory to load images, or if it hogs memory. The setting -Xmx1024m allows Jim to use a maximum of 1024 MB of memory, regardless of how much RAM your computer has. You can increase this number if you find that Jim runs out of memory. For example, to allow Jim to use a maximum of 2048 MB of memory, change it to -Xmx2048m
The setting -Xms16m set the amount of memory consumed by Jim immediately on startup, and should not need to be changed.
If Jim cannot find the license file, you can tell it explicitly where to look. Change the setting of -Dlicense.filename=license.txt to give the exact path to the license file. For example:
-Dlicense.filename=/Users/xinapse/license.txt
if you the user xinapse put your license file in his home folder.

You can customise the amount of memory used by each of Jim's stand-alone tools in exactly the same way above, to tailor the amount of memory used, etc. Do this by editing the appropriate Info.plist file for the tool.

Running the Stand-Alone Tools in Batch (Text-Only) Mode

Also included in the install directory is a subdirectory called Unix, which contains c-shell scripts that allow you to run tools wither in graphical (GUI) mode or in text-only (batch) mode. One of these scripts (called RunTool) is a master script that contains comments and instructions on how to change certain settings for Jim and the stand-alone tools.

Open the script RunTool using your favourite text editor (having first copied the script to a backup file), and customise it using the instructions written in the script. Don't forget to make the scripts in the Unix directory executable for all your users:

chmod 755 *

Once you have customised RunTool, copy it and all the other scripts in the Unix directory to an executable directory that is in the path of every user (such as /usr/bin or /usr/local/bin).

Jim Home