Installing Intonia

There are three installers for Intonia:

Using the .exe installer

The .exe installer works only under Windows 2000 or later. Download the file to your desktop and double-click it.

The default installation will make Intonia available only to the user account that did the installing. If you want Intonia available to all users on the same computer, instead of double-clicking the installer icon, right-click it instead, and select "Run as Administrator".

The .exe installer first checks to see if you have at least Version 6.0 of Java. If you have the required version, you can skip to the next paragraph, but if you don't have it, you will get an error message. Then after a short delay you will be directed to a website where you can download and install it. Click "Download Free Java". On the next page that comes up, click "Download Now". If the download doesn't appear to be happening, be sure to read down the page for specific instructions for your browser: Internet Explorer or Firefox. After the Java installation is complete, double-click the InstallIntonia icon again.

The next step is to present you with the End User License Agreement. Read the license agreement carefully. You must agree to the terms and conditions in order to install the software. If you do not agree, click Cancel and the installation will be stopped.

Keep clicking through the boxes until the installation is finished. It will add Intonia to your Start Menu, and it will leave an icon labeled Intonia on your desktop. After you verify that everything works, you may remove the installation file from your desktop.

(If Windows pops up a window saying, "This program may not have installed correctly," simply choose "It installed correctly.")

Once the program is installed, you can start it by double-clicking its icon on the desktop.

Using the .pkg installer

The .pkg installer is for the Macintosh OSX operating system. Download the file to your Downloads directory. Double-click the InstallIntonia icon.

The installer will present you with the End User License Agreement. Read the license agreement carefully. You must agree to the terms and conditions in order to install the software. If you do not agree, click Disagree and the installation will be stopped.

You may be prompted for your Mac password to complete the installation. Keep clicking through the boxes until the installation is finished.

The installer will overwrite the existing Intonia installation, leaving all your files, preferences, and license keys intact. If you're upgrading from version 1.3.1 or earlier, there may be two copies of Intonia in your Application folder. Remove the old one, keeping the one with an icon that has a letter i on a red, white, and blue treble clef.

After you verify that everything works, you may remove the installation file from the Downloads directory.

Using the .jar installer

The .jar installer will work with any computer that has a working Java Runtime Environment. However, Windows users are encouraged to use the .exe installer and OSX users are encouraged to use the .pkg installer instead.

The .jar installer first checks to see if you have at least Version 5.0 of Java. If you have the required version, you can skip to the next paragraph, but if you don't have it, you will get an error message. See below for information about how to upgrade your Java.

The next step is to present you with the End User License Agreement. Read the license agreement carefully. You must agree to the terms and conditions in order to install the software. If you do not agree, click Cancel and the installation will be stopped.

Keep clicking through the boxes until the installation is finished. On Mac OSX, the .jar installer will copy files to a folder named /Applications/Intonia. You can remove the InstallIntonia.jar after everything works, by dragging it to the trash.

Once the program is installed, you can start it by using the Finder to navigate to /Applications/Intonia and double-clicking Intonia.jar. Or you may wish to drag the Intonia.jar icon to the far right end of your dock, from where you can invoke Intonia without using the Finder.

About Java and its versions

Intonia depends on Java, a free product that is distributed by java.com. It allows software products to run identically on a variety of platforms, including Windows, Macintosh, and various flavors of unix and linux.

Version numbers of Java can sometimes be confusing. The early versions were labeled 1.0 through 1.4. The next version (introduced in 2004) is sometimes called 1.5 and sometimes called 5.0. Java 6 was introduced in 2006. The current version is Java 7, introduced in 2011.

Java for Mac OSX is distributed by Apple.com, not by Java.com. Their versions are perennially behind the versions available from Java. Java Version 6.0 was released by Apple in May, 2008, but only for OSX 10.5 (Leopard). Some older versions of OSX may have version 1.4, which will not support Intonia at all.

I wrote Intonia to take advantage of some of the features of Java Version 6. However, it will run fine using Version 5. If you're on a Macintosh or any other system with Version 5, you'll miss out on some features related to licensing, error reporting, interfacing to websites, and volume controls.

Windows users can find the latest version of Java at http://java.com. If you're running Mac OSX, you can find the latest Java version at http://www.apple.com/support/downloads/. Linux users should visit http://java.sun.com/javase/downloads/index.jsp.