Objects Pty Ltd

Scan lite Installation

josi Scan lite is a scanning frontend designed for using both local and remote scanners. It currently supports accessing SANE scanners via the saned daemon.

NB. You must have saned running for josi to access your SANE scanner.

Once you have downloaded josi and extracted the file in the zip distribution you should have a josi directory containing two directories 'bin' and 'lib'. Then use the following steps to complete the installation.

Step 1.

Install Java Runtime Environment (if not already installed). The latest version can be downloaded from the following locations depending on your OS:

If you are installing Java 1.1 then you will also need to install Swing (if not already installed). Which can be found here.

Step 2.

Download the JIMI class library (if not included in the zip file) and put it in the lib directory. This can be downloaded here.

Step 3. (For Windows, OS/2 and Unix users)

Add the bin directory to your path.

Set the JOSI_HOME environment variable. This should be set to the directory which contains the bin and lib directory.

Set the JAVA_HOME environment variable. This should be set to the directory where the Java Runtime is installed.

Windows and OS/2

Assume josi is installed in c:\josi\. The following sets up the environment:

set JOSI_HOME=c:\josi
set JAVA_HOME=c:\jdk1.3
set PATH=%PATH%;%JOSI_HOME%\bin

Unix (bash)

Assume josi is installed in /usr/local/josi. The following sets up the environment:

export JOSI_HOME=/usr/local/josi
export JAVA_HOME=/usr/local/jdk-1.3
export PATH=${PATH}:${JOSI_HOME}/bin

Step 3. (For Macintosh users)

Place the jar files josiscanlite.jar and jimi.jar into the MRJClasses folder. Start JBindery and enter the following:

Class name: JosiScanLite
Optional Parameters: <scanhost> <devicename>

where  is the name of the host running saned
and  is the name of the scanning devices (this is optional).

Save those settings.

Step 4.

Installation should now be complete.

To run josi there are scripts available in the bin directory for Windows and Unix with the following usage:

Windows

josiscanlite [[<host>][:<port>] [<device>]]

where:
   is the name of the host running saned (default: localhost) 
   is the port number used to connect to  (default: 6566) 
 is the name of the scanning device.  (If none is specified
         then a list of available devices is presented)

Unix

josiscanlite.sh [[<host>][:<port>] [<device>]]

where:
 is the name of the host running saned (default: localhost) 
 is the port number used to connect to  (default: 6566) 
 is the name of the scanning device.  (If none is specified
       then a list of available devices is presented)

OS/2

We currently do not have an OS/2 CMD file available to start josi. Until this script becomes available try the following command:

java -Djosi.home=<home> [-Djosi.host=<host>] [-Djosi.port=<port>] [-Djosi.device=<device>] -classpath <home>/lib/josiscanlite.jar;<home>/lib/jimi.jar;%CLASSPATH% JosiScanLite

where:
 is the directory josi is installed in
 is the name of the host running saned (default: localhost) 
 is the port number used to connect to  (default: 6566) 
 is the name of the scanning device.  (If none is specified
       then a list of available devices is presented)

Macintosh

Simply double-click on the saved JBindery setting.

Others

java -Djosi.home=<home> [-Djosi.host=<host>] [-Djosi.port=<port>] [-Djosi.device=<device>] -jar <home>/lib/josiscanlite.jar JosiScanLite

where:
 is the directory josi is installed in
 is the name of the host running saned (default: localhost) 
 is the port number used to connect to  (default: 6566) 
 is the name of the scanning device.  (If none is specified
       then a list of available devices is presented)

If you have any problems at all then please contact us at support@objects.com.au and we'll assist you with your installation.