Microsoft Windows Installation

These instructions are for installing Jim 10 on 64-bit Windows operating systems.

Installation of Jim under Microsoft Windows is in five stages:

  1. Install the Jim software package
  2. Request a license
  3. Install the license
  4. Customise the installation (optional)
  5. Download some example images (optional)

Jim Installation. There are two ways to install Jim 10, depending on whether you already have Java version 25 installed.

  • If you already have Java 25 installed, download jim-10-installer.exe to the Desktop. Then click with the right mouse button on jim-10-installer.exe and select "Run as administrator". This will launch the installer. You can get Java 25 from the Oracle Java Archive.

  • If you are running and Windows 11 and don't already have Java 25 installed (or don't know), download Jim10Installer.zip to the Desktop. Click with the right mouse button on the downloaded zip file, and then on the Extract All extracting all files from a zip archive and extract the files to your Desktop.

Open the folder to which the files were extracted, then click with the right mouse button on jim-10-installer.exe and select "Run as administrator". This will launch the installer.

Note: If you are re-installing the same version of Jim, copy your existing license file (license.txt) from the installation folder to a safe place. Any batch files that you created or customised for the previous release may also need to be saved or recreated and re-customised.

In the installer, when you come to set the "installation path", you can do either:

  • A system-wide installation. Set the installation path "C:\Program Files\Xinapse\Jim10".
  • A personal installation (for your own use). Set the installation path "C:\Users\Username\Xinapse\Jim10", where Username is your own user name.

In either case, you may need Administrator rights.

License Request. The easiest way to obtain the details needed to send for a license is to try starting Jim. To start Jim, go to the Start button, then select Programs (All Programs on Windows 7; All Apps on Windows 10), program group Jim10, then the Jim10 menu item. If you have not yet received a license file, you will see a pop-up error dialog like the one shown below.

Pop-up window showing no license on Windows

You will see a line that says something like:

  • This computer's Host ID is "000123456789"
    E-mail this string of digits/letters to Sending for a license.

Note: you can automatically compose an e-mail to request the license if you click the Button to compose an e-mail to send for a license button.

Note: use your professional or institutional email address. If you do not, you may not receive a reply.

Note: this is not an automated service, and there will be a delay before you receive your license file.

Be careful when copying the hostid: if you send the incorrect hostid, Jim will not work. Each hostid is 12 characters long, and consists of the digits 0..9 and the letters A..F.

If you have purchased network (floating) licenses, you can set up the connection to your license server by clicking on the Button to connect to a license server button. See the instructions for setting up a connection to a license server.

Installing the License. The license file you will receive by e-mail should be saved to a text file, and copied into the directory where you installed Jim (most likely C:\Program Files\Xinapse\Jim10). Ensure that the name of this file is "license.txt". (The installation directory is the directory that also contains (amongst others) the file "xinapse10.jar"). You should now be able to start Jim and its stand-alone tools from the Start button under All Programs, Jim10 then the Jim10 menu item. If not, e-mail Xinapse Systems support who will help you to resolve the problem.

If you have received and believe you correctly installed your license file, then you can get Jim to print out more detailed messages about why licensing has failed. Press the debugging licensing button. This will pop up a further dialog containing detailed license debugging messages. You can use these to diagnose the problem, or e-mail the messages shown in this window to Xinapse Systems support, to help us to diagnose the problem.

Also see the section about customising a Windows installation.

You may also wish to download some example images to get you going with Jim.