If not already done, install the JRE (Java Runtime Environment) or the corresponding browser plugin. The latest JRE can be downloaded from Sun. Install jdk1.6 or higher, earlier versions won't work!

Get the latest release from the SourceForge project page. The archive jboom (as tar.gz or zip) contains the installer and the documentation. You don't need jboom-src except if you are interested in the program source. Download and unpack the archive into any directory.

Start the installer using the command

java -jar jbinstall.jar

On graphical systems a double click on jbinstall.jar should be sufficient.

You have to choose between a local installation, which has to be repeated an each system, and a remote installation, which has to be carried out only once. For a remote installation you need access to an HTTP server. Many providers offer a sufficient amount of web space for free, so this shouldn't be a problem.

The installer lets you choose between a simple and an expert installation. A simple installation uses standard settings wherever possible. An expert installation leaves you more influence on file locations and names, but you have to enter more details.

Before the installation, consider

• whether you want to use jBoom as a program or an applet (see variants),
• whether you want to install jBoom locally or on a server,
• how you access the server (via FTP or SCP).

The installer will guide you through the necessary steps. After a successful installation it shows you the command that starts jBoom. You will also find this command in the file jbinstall.txt in your home directory, and in the system clipboard.

Windows users may want to create a shortcut to javaw from the JRE (e.g., on the desktop). After creating, right-click on the link and add the parameter in the properties / target field.

If you know what you are doing, you can install jBoom without the installer. However, you need sufficient knowledge about html and jnlp files. To only extract the program file, call the installer with the option -x:

java -jar jbinstall.jar -x

This will create the file jboom.jar in the working directory. See chapter program parameters for the parameters jBoom takes.

To update an existing jBoom installation, you can repeat the whole installation process. However, normally it is sufficient to extract the file jboom.jar (as described above) and replace the old version by this one.

Here are some icons for your desktop. They are based on the Yasis icon theme (under the GNU GPL).

png format, 48x48	png format, 32x32	png format, 16x16
ico format, 48x48	ico format, 32x32	ico format, 16x16

The tray icon has been borrowed from the Nuovo icon set (also under GNU GPL).