Cantabile Zip Archive
=====================

This is a zip archive of the Cantabile distribution package.  


Installation
------------

In general these files can be copied to anywhere on your local hard drive 
and/or portable drive and they will work just fine (assuming you have the 
required .NET Framework installed).

For best performance however please follow these steps:

1. Copy this folder to the target location of your choice
2. Generate native images.  (Optional, but highly recommended)
3. Configure network (Only required if running Cantabile's network server)
4. Register shell associations

Following the above steps will result in an installation functionally
identical to running the official setup program

Note there are two versions of the zip archive - one for x86 and one for 
x64.  Make sure you're running the correct version for your operating
system and the kind of plugins you want to run.



Generating Native Images
------------------------

Although not required to work, Cantabile will load faster and be less prone
to random UI stalls if you run the native image generation tool.  Ngen is a 
Microsoft utility that generates native executable images for the target
machine and removes the need for this to be done at runtime.

This zip archive includes a file "runngen.bat" the will build the native
images for the required files.  You need to run this  file as Adminstrator 
and from the target folder where you want to run Cantabile.



Configure Network
-----------------

If you want to use Cantabile Performer's built-in network server/Web UI you
need to configure certain network settings.  

This zip archive includes a file "configureNetwork.bat" that configures things 
correctly.  To configure the network, from a command prompt run the batch file 
as follows:

>configureNetwork install



Registering Shell Associations
------------------------------

Shell associations let you open Cantabile files by double clicking them in 
Windows Explorer (aka File Explorer).  To create these file associations:

1. Install Cantabile as described above
2. Run Cantabile
3. Go to Tools -> Options -> Miscellaneous -> File Associations
4. Click the "Associate" button



Uninstalling
------------

To uninstall and remove Cantabile completely, follow these steps:

1. Remove file associations (as above but click the Unassociate button)

2. Remove network configuration

    > configureNetwork uninstall

3. Remove native images:

	> runngen uninstall

4. Delete the folder and all contained files

5. If desired, delete Cantabile created files (songs, racks etc...) from

	C:\Users\<yourusername>\Documents\Cantabile

6. If desired, delete settings folder:
	
	C:\Users\<yourusername>\AppData\Local\Topten Software

