==================================
=VMware Live CD ISO Player ReadMe=
==================================

What you need to do:
====================

Read this whole thing.  Yes, really.



What this is:
=============

This is a set of shell scripts (Linux/Unix)  to boot a Live CD-ROM image (.iso) with minimal effort, using either VMware Workstation or VMware Player.  While it has several command line switches (type `./isoplayer.sh --help` in Linux and `isoplayer /?` in Windows for a complete list with descriptions), it is meant to be used in the right-click context menu for the .iso file type.


Installation:
=============

Under Linux:
------------


The config-isoplayer.sh script is provided to configure GNOME and KDE to use the script.  Note that it may not necessarily work with your distribution, and if after running it ISO images are not associated with this script, then you may need to do this maually.  Instructions for that will follow.  The effects of this script may not be immediate; you may need to open a new Nautilus/Konqueror window for it to work.

DISCLAIMER: While I did extensive testing to the config-isoplayer.sh script, I have noticed that (on very rare occasions) the mimeinfo.cache file becomes damaged.  While I believe that this bug had been repaired, it is still reccomended that you back up that file (~/.local/share/applications/ for user, /usr/share/applications/ for everyone) and use that script AT YOUR OWN RISK.


Manually - GNOME:
-----------------

Right click on an .iso file in Nautilus and select "Properties".  In the Properties window, select the "Open With" tab, then click "Add".  Click "Use a custom command" and in the box, enter the the isoplayer.sh script's filename with the full path, followed by any command line options and finally %f.  Two options you will probably want to include are:

  -d          This will delete the temporary files upon shutdown of the virtual machine
  --vmware=   This, followed by your vmware executable is necessary if you are using something other than /usr/bin/vmware (for example, VMware Player is /usr/bin/vmplayer)

For example if you placed the script in isoplayer/ under your home directory and you are using VMware Player, you might enter this:
'/home/username/isoplayer/isoplayer.sh' -d --vmware="/usr/bin/vmplayer" %f

Finally, click "Add".


Manually - KDE:
---------------

Right click on an .iso file in Konqueror and select "Properties".  In the Properties window, click the "Edit file type" button (looks like a wrench).  Under "Application Preference Order", click "Add..."  In the text box at the top of the "Choose Application" dialog, enter the script with arguments, then click "OK".  For the proper syntax, refer to what was said in the Manually - GNOME section above.




Advanced:
=========

The scripts accept several command line arguments (and more goodies are planned for a future release).  Just type
  `./isoplayer.sh --help` in Linux
and
  `isoplayer /?` in Windows
for a complete list with descriptions.

Also, there are two variables that you can set in your Operating System that will override the defaults:

  ISOPLAYER_VMWARE  Set this to the VMware Executable to avoid passing it as a command line argument
  ISOPLAYER_TMP     Set this to an alternate temp directory


Known Issues:
=============

The --mem= argument does not perform any error checking.  So don't pass anything non-numeric.


---------------------------------------------------------------------------------------------------
THIS IS THE INSTALL PROCEDURE IN kurumin (but you have to read the WHOLE PAGE first !!!!)
--------------------------------------------------------------------------------------------------
Copy the image of a live-cd (knoppixLIVE.iso for instance) into this folder.
Then copy the folder to your desktop.
Open a terminal (do "sudo passwd" if you want to set a root password in Kurumin), then "sudo su"
Then navigate to 
cd /home/kurumin/Desktop/isoplayerlinux
Then install the script with the command
./config-isoplayer.sh
You can accept all the proposed settings, and then VMWARE ISOPLAYER will be installed.
Whenever you click on any .iso file that is in this folder, it will automatically open VMWARE player or VMWARE WORKSTATION,ready to launch the
live-cd.


Legal Crap:
===========
DISCLAIMER:
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Copyright (c) 2006 Mike Baum
mbaum2000@gmail.com (please don't spam)