Installation

Mac OS X

The Macintosh version of Balloonist requires Mac OS X 10.4 (Tiger). It is recommended that all available Internet Software Updates be applied.

Balloonist has been tested on PowerPC architecture and should also work on Macintosh computers with Intel architectures.

To install from the Internet, download the Mac OS X distribution from http://www.smithandtinkers.com/balloonist

You should be presented with a Finder window containing the Balloonist application. With some web browsers, you may first need to double-click the downloaded archive file, which will have a name like balloonist-1.00.dmg.

Finally, drag the Balloonist application icon to your Applications folder. You should now be able to run Balloonist from your Application folder by double-clicking on it.

Windows

We recommend that Windows users run Balloonist on Windows XP. If necessary, you should also be able to run Balloonist on Windows 98, Windows NT, Windows 2000 or Windows ME.

To install from the Internet, download the Windows distribution from http://www.smithandtinkers.com/balloonist

Balloonist for Windows comes packaged as a zip archive. Windows XP is able to handle zip archives natively, but earlier versions of Windows may require additional archive management software like WinZip (http://www.winzip.com).

Copy your unpacked Balloonist distribution to the Program Files directory on your computer using Windows Explorer. This will typically be located on your c: drive. You should be able to run Balloonist from here by double-clicking on its application icon, which will be labeled Balloonist.exe.

If, after double-clicking, you are presented with a toolbar and workspace, then your installation is complete and you may advance to the next section.

If, on the other hand, you receive an alert dialogue, you may need to install additional software. Balloonist requires the Java Runtime Environment to operate. This is generally but not systematically provided with the Windows operating system.

If you receive a message that Java needs to be installed or "Could not find the main class", dismiss the dialogue, visit http://www.java.com and follow the instructions there for downloading a version 1.4 or 5.0 Java Runtime Environment.

Other Operating Systems

Balloonist should be able to run on any system capable of operating a version 1.5 or 1.4 Java Runtime Environment.

Java is installed by default on Solaris, and also ships with most Linux distributions.

Download and unzip the Java Balloonist distribution to your home directory or a subdirectory underneath it.

Once unpackaged, you should be able to open the resulting balloonist.jar file from your desktop manager.

Some older desktop managers may not have a file association for Java executables. Others may incorrectly associate them with a zip archive management application. To manually start Balloonist, open up a command shell, change to the unpacked directory using the cd command, and enter the instruction java -jar balloonist.jar

Although you may safely move the unpacked application directory, it is imperative that you not change the location of balloonist.jar relative to its companion Java executable files.