Thanks for your interest in using Cosmophone v1.0 . This guide will help you in installing and running the Cosmophone application. The guide is organized as follows.

(1) Hardware requirements.

(2) Software requirements.

(3) Installation of Cosmophone v1.0

(4) How to run Cosmophone v1.0 ?

(5) Registering capture devices with JMF.

The hardware requirements for Cosmophone application are the same as the hardware requirements of JMF 2.0. The requirements vary depending upon the platform ( Windows, Solaris or Linux). For the case of a Windows platform the requirements are as follows:

1. 486 or Pentium based PC.
2. Display card supporting 8, 16, 32 bit display mode.
3. 32 MB RAM or greater

.

4. Optional: SoundBlaster - compatible sound card for Windows machine without built-in audio support.
5. Optional: video capture device supporting Video for Windows ( VFW).

1. Any operating system supporting JDK1.2 and JMF 2.0 or above. ( Example Windows 95/98/NT, Solaris, Linux)
2. Java Development Kit JDK 1.2 or later OR Java run time environment 1.3.0 or above.
3. Java Media Framework JMF 2.0 or later.

For the full details on the hardware and software requirements for different operating systems and for the supported audio and video capture devices consult the webpage http://java.sun.com/products/java-media/jmf/2.1/requirements.html. For your convenience a copy of this webpage as on 25/2/2001 is enclosed along with this package. You are advised to refer to the latest version of this page.

Cosmophone requires the Java Run time Environment (JRE) and the Java Media Framework ( JMF) to operate. Therefore you should first install JRE and JMF in case they are not already installed in your computer. In case you have obtained a CDROM version of the Cosmophone application the installation files for the JRE and the JMF for the Windows and the Linux operating systems are present in the CDROM itself in the directories Windows and Linux respectively. Install JRE and JMF from the CDROM and skip steps (a) and (b) given below.

If you have a obtained the floppy version OR the freely downloadable version of the Cosmophone application then follow steps (a) and (b) given below.

To install JRE go to the website

"http://java.sun.com/products/?frontpage-footer" and download and install the Java 2 SDK OR Java 2 runtime environment V 1.2.2 ( or above ) for the platform you want to install.

To install JMF go to the website

http://java.sun.com/products/java-media/jmf/index.html and download the JMF 2.0 ( or above) installation file for the platform you want to install. Follow the installation procedure given in the above website and install the JMF. In case of the Windows operating system the "Windows performance pack" is recommended.

(i) Copy the contents of the Cosmophone directory present in the floppy disc/ CDROM into your hard disk in a directory of your choice (say for example c:\ ). Note that you have to copy the Cosmophone directory with its directory structure intact as it is present in the floppy/CDROM ( this is required for the Java packaging to work). In the case of Windows operating system it is recommended that you use the Windows explorer and its "copy and paste" utility to copy the Cosmophone directory.

For the example given above the directory structure will now be c:\Cosmophone. You will find the directory "IPhone" in "c:\Cosmophone". In turn the IPhone directory will have many files and two sub directories called "VoiceMail" and "VideoConf". In turn the "VideoConf" directory will have a sub directory "JavaChat".

(ii) Include the Cosmophone directory in the CLASSPATH. For the Windows operating system edit the autoexec.bat file and include in the CLASSPATH the full path name of the Cosmophone directory followed by a "\" and ";". For the above example the string will be:

c:\cosmophone\;

Note that the backslash and semicolon at the end are important.

3. Restart the computer.

To run the Cosmophone application execute the following command from the MSDOS prompt/command line with the current directory as the IPhone directory:

java IPhone.IPhone

For the above example the command would be c:\Cosmophone\IPhone> java IPhone.IPhone

For the sake of convenience, you can create a batch file and run Cosmophone using it in a Windows operating system. An example batch file called "Cosmophone.bat" is given in the floppy/CDROM. The Cosmophone.bat given here is for the case where the Cosmophone directory is present in "c:\". It reads as

c:

cd \

cd Cosmophone\IPhone

java IPhone.IPhone

This batch file changes the present working directory to the IPhone directory and then executes the command "java IPhone.IPhone". Edit this batch file depending upon where you have placed the IPhone directory. Include the Cosmophone.bat file in the "Windows\Desktop" directory. You will see that an icon called "Cosmophone" has been added to the desktop's front panel. Now if you double click on this "Cosmophone" icon the Cosmophone application will automatically get started.

Optionally you may wish to change the look of the icon attached with the Cosmophone.bat file as follows. Right-click the mouse on the Cosmophone.bat. Go through "Properties" -> "Program" -> "Change Icon". Give the Icon file name as the absolute path name of the file called phoneIcon present in the IPhone directory.

Refer to the User's manual or use the Help option in the option tab pane of the Cosmophone application to get help on how to use Cosmophone.

JMF and in turn the Cosmophone application requires that all audio and video capture devices ( sound card and web Camera ) should be registered with the JMF Registry. Only then the Cosmophone application can make use of them. During the installation of JMF, it automatically registers all installed capture devices ( that are supprted by JMF ) with its JMF Registry. In case you decide to add any capture device after the above installation procedure you should explicitly register the capture devices by following the steps given below:

(i) Install the device as specified by its supplier.

(ii) To register these capture devices with the JMF Registry run the command :

java JMFRegistry

A window titled "JMF Registry Editor" will open up. Go to the tab Pane "Capture Devices" which gives a list of registered capture devices. Click the button "Detect Capture Devices". After few minutes the list of audio and video capture devices will get updated with the new devices.

In case you encounter any problem in installing the Cosmophone application contact us by sending an email to :

cosmos_software@vsnl.net

We would be happy to help you.