====================================
    Midi Magic XPro Version 1.0

      Midi Multi-File Player

  Copyright 1998 Douglas M. Berger

      Setup and Readme File
====================================

***SPECIAL NOTES***

Please read the License.txt file as well as this file. Although this is a freeware product, you are still bound to the terms of the license agreement.

The contents of this file are shown from within the installation program, before any files are installed.

-------------------------------------
             Contents

1.  What is Midi Magic XPro
2.  Installation
2.1 System Requirements
2.2 Installing Midi Magic XPro
2.3 Files Installed
3.  Uninstalling Midi Magic XPro
3.1 Registry Settings for Midi Magic XPro Options
3.2 Custom Uninstallation Considerations
4.  On Line Help
5.  Registration and Technical Support
-------------------------------------


1. What is Midi Magic XPro

Midi Magic XPro is a 32-bit Windows program that plays Midi files. A Midi file can be opened and then played, or multiple Midi files can be added to a list for playing (called the Play List). Such a list can be saved to a list definition file, called a Magic file, and then opened at a future time to recover the Midi list of files. 

Midi Magic XPro has a graphical interface supporting the necessary song controls and associated status of the Midi file being played. The application can be minimized to the system tray while the Play List is playing, with simple actions available from the system tray to control the playing status. Editing a Play List allows for the addition of any Midi file, with optional saving / resaving to the Magic file. Program options are also available for customization of application elements.


2. Installing Midi Magic XPro

2.1 System Requirements

- A PC running Windows 95 or Windows NT 4.0. Windows NT 4.0 requires that Service Pack 2 or later be installed.

- Approximately 3 MB hard disk space for all files; most of the space is required in the Windows System directory.

- A Windows compatible sound card that supports Midi sequence files, and speakers.

Given that the distribution contains various common files that may already be on your system, your hard disk space requirements may be less.

Midi Magic XPro will eventually be tested on the next releases of Windows 95 and Windows NT (currently named Windows 98 and Windows NT 5.0, respectively).


2.2 Installing Midi Magic XPro

This application is normally distributed in zip format. Contained within the zip file are 3 files: setup.exe, readme.txt, and license.txt. The setup file setup.exe is the only file necessary for installation of Midi Magic XPro. To install Midi Magic XPro, just unzip the setup.exe file to any directory of your choosing, then run it. The installation program will guide you through dialogs, giving you an opportunity to choose custom installation settings. It is strongly advisable not to cancel the installation during the actual copying of files to your system; you will get the appropriate message when actual file copying is about to begin. If you choose, you can uninstall the application afterwards using the "Add/Remove Programs" Control Panel applet, which is described in Section 3.

Readme.txt and license.txt are provided separately for your convenience. The installation program will install these files without the need for the copies provided separately in the zip file. Additionally, the setup program will display their contents from within its installation routine before any Midi Magic XPro files are installed to your system; this also does not require the copies provided separately in the zip file.

To reinstall Midi Magic XPro, first uninstall an existing installation as described in Section 3, then install as mentioned above.


2.3 Files Installed

The following files are installed onto your PC:

Application Directory
---------------------
Install.log
License.txt
MidiMag.cnt
MidiMag.exe
MidiMag.hlp
Readme.txt
Register.txt
Uninstal.exe
Webdlt.exe

Windows System Directory
------------------------
Asycfilt.dll
Comcat.dll
Ctl3d32.dll
Mci32.ocx
Msvbvm50.dll
Oleaut32.dll
Olepro32.dll
Stbole2.tlb
Tabctl32.ocx
Vbdmblcd.dll


Other Installation Actions:

- Shortcuts will be created for the Midi Magic XPro program, its help file, and its readme file, in the program folder you specify during installation.

- Registry entries will be added to support the uninstallation of Midi Magic XPro.

- Registry entries will be added to support most of the system files.

SPECIAL NOTES:

- The file install.log should not be edited in any way. This file is used by the uninstall program to determine the files and settings that can be uninstalled.

- Any files in the system directory that are a later version than the ones distributed with Midi Magic XPro will not be overwritten by the Midi Magic XPro installation.


3. Uninstalling Midi Magic XPro

You remove Midi Magic XPro using the "Add/Remove Programs" Control Panel applet available in Windows. Select the Midi Magic XPro program in the program list, then click the Add/Remove button.

At this point, you will have the option of selecting an "automatic" or "custom" uninstallation. The automatic uninstallation is recommended to remove all elements of Midi Magic XPro. The custom uninstallation should typically only be used if you choose to retain Midi Magic XPro option settings in the Windows Registry, which you may want to do if you need to reinstall Midi Magic XPro or upgrade to a newer version (read the documentation associated with a newer version to determine if the option settings are still relevant). See below for more information on removing Registry settings.

The removal of Midi Magic XPro will not remove any Magic files (.mag) that were created by the user with Midi Magic XPro. You can use these files if you install Midi Magic XPro on another PC or reinstall on the same PC.

While the removal of Midi Magic XPro is occurring (automatic or custom), you may be provided with one or more warning messages asking you if a file should be removed from the PC. Typically, these warnings will be for shared (or sharable) files in the Windows System directory. Generally, you can allow the uninstallation program to remove these files, as Windows does not remove a file (and does not prompt the user whether to remove it) if it knows that another program is using the same file, based on info in the Registry. Since most Windows 95 and NT programs do update the registry with this info, then it is likely that removal would not cause a problem. If in doubt, you can leave these files, and you will not violate the Midi Magic XPro license agreement.


3.1 Registry Settings for Midi Magic XPro Options

Midi Magic XPro options, most of which are settable by the user via the Options Screen, are stored in the Windows Registry. During a custom uninstallation, you have the option of removing Registry settings. During an automatic uninstallation, all settings are deleted. The following lists the Registry items you can select: 

- SOFTWARE/Classes/MidiMagicXPro
- SOFTWARE/DBerger XPro/MidiMagicXPro

The above settings are beneath the HKEY_LOCAL_MACHINE branch, but this is not shown on the list.

Simply put, if you plan on reinstalling Midi Magic XPro or upgrading to a new version, do not select these settings for removal. If you do not plan to install Midi Magic XPro again, then select both of these setting for removal. Overall, it is strongly recommended that you use the automatic uninstallation option for all uninstallations except when you need to retain these 2 Registry settings.

Note that 2 other Registry settings are not available for removal. They are the HKEY_LOCAL_MACHINE/SOFTWARE/Classes/.mag and HKEY_LOCAL_MACHINE/SOFTWARE/DBerger XPro settings. These settings are not available for removal due to the possibility that other applications may make use of them. If you know that they are not being used and have experience editing the Registry manually, you can delete these keys. This is not recommended for anyone without good knowledge of the Registry. As a precaution, back up the Registry before attempting this action.


3.2 Custom Uninstallation Considerations

Other than the Midi Magic XPro Registry settings mentioned in the previous section, it is strongly recommended that all other files, directories and Registry settings be selected for deletion. Note that even if you run an automatic uninstallation, all of the option settings excluding the most recently used file list can be quickly recovered via the Options Screen.


4. On-Line Help

Midi Magic XPro includes a comprehensive windows help file that can be invoked independently from Midi Magic XPro or from within the Midi Magic XPro program. From within Midi Magic XPro, use either the Help Menu items on the menu bars, the Help Toolbar Commands, or the F1 key. The Help Topics construct is available via these mechanisms, which includes a Contents tab, an Index tab, and a Find tab. All information in the provided text files, including this one, can also be found in the help file.


5. Registration and Technical Support

See the register.txt file or the on-line help for information. Registration is optional.
