Softsqueeze 2.0

To use Softsqueeze first you will need to install:

Java (version 1.4 or better)
Slimserver 6.0 or above

You might not have to download; Softsqueeze2 is included with the slimserver 6.0. To start Softsqueeze follow the instructions in the help section of the slimserver.

If you need a different version of Softsqueeze, or want to install Softsqueeze on a remote PC then follow these instructions:

How to download Softsqueeze

You must download the correct version of Softsqueeze to work with you slimserver version, Softsqueeze2 requires slimserver 6.0 or greater. The latest binary distribution is available from the SourceForge download area. On Windows or Linux download the .zip file. OS X users can install using the .dmg file.

Then once you have downloaded and uncompressed the Softsqueeze zip file, double click on the Softsqueeze.jar file to start the application (on some platforms you might have to start Softsqueeze from the command line).

When you first start Softsqueeze you will be asked for the server IP address and Slimserver version. You can change these settings later in the preferences dialog.

Slimserver integration - Java Web Start and Applets

The Slimserver includes a version of Softsqueeze that can be launched using either Java Web Start or as a Java applet. Click the Softsqueeze link in the help section of the slimserver, and the follow the instructions to start Softsqueeze or by opening one of the following url's (replace localhost with the hostname of your slimserver):

http://localhost:9000/html/softsqueeze/applet.html
http://localhost:9000/html/softsqueeze/webstart.html

You can upgrade Softsqueeze as follows;

Download and unpack the Softsqueeze.zip file.
Locate your slimserver installation. For example C:\Program Files\slimserver.
Move the contexts of the Softsqueeze folder you download into the folder HTML/EN/html/softsqueeze. The restart your slimserver.

Slimserver integration on a OS X

To update Softsqueeze in the Slimserver preference pane;

Download and unpack the Softsqueeze.zip file.
Locate slimserver preference pane: Library/Preference Panes/SlimServer.prefPane
(Not System/Library/Preference Panes, though if slimserver was installed for a user rather than for the system it may be in Users/USERNAME/Library/Preference Panes/SlimServer.prefPane).
Right click or control click on the preference pane and select 'Show Package Contents’. You may have to log in as admin to access this option.
Move the contents of the Softsqueeze folder you downloaded into Contents/Server/HTML/EN/html/softsqueeze You’ll get a warning about replacing files, click on 'OK to all’. You may have to put in your admin password if not logged in as admin.

Other web servers - Java Web Start

Softsqueeze can be distributed using Java Web Start - a technology that allows Java applications to be launched from a web browser. If you have a web server then you can enable Softsqueeze to use Java Web Start as follows:

Unpack the Softsqueeze.zip file in your web server documents folder (for example htdocs in apache).
Configure you web server to include the MIME type 'application/x-java-jnlp-file' for .jnlp files.
Edit the softsqueeze.jnlp file. You need to add the absolute path to the jnlp file in the codebase attribute (relative paths do not work). Change the slimserver property value as appropriate for your server.
Link the softsqueeze.jnlp file into a existing html document.
Clicking on the link in your html document will then launch the Softsqueeze application and automatically connect to your server.

In the current release you will get a security warning when you use Java Web Start to launch Softsqueeze. It will recommend that you do not run the application because it has not been correctly signed. Ignore this warning :).

Command line

To start Softsqueeze from the command line using the java command you need to:

cd <Softsqueeze directory>
java -jar SoftSqueeze.jar

Source code

The source code for the project is available from the Slim Devices Subversion tree. You can browse the code in your web browser, or use your Subversion client to check out the latest version using:

svn co http://svn.slimdevices.com/repos/slim/trunk/softsqueeze.

Softsqueeze is released under the GPL license.