PLAY-PAK -- MIDI File Player Utilities
                       Copyright 1990,  Kevin Weiner
                            All rights reserved


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

It is suggested that all the included files be copied into a subdirectory
and that the subdirectory be added to the DOS search path for ease of
use.  If you are using a MIDI interface with non-standard IRQ or port
settings, see the device setup section below for proper set up.


Hardware
--------

Play has the largest memory requirement of the included programs.  It
needs a minimum of 142K of available ram, plus the amount of memory
required to store the largest MIDI file to be played.  The following
MIDI interfaces are supported: all Roland MPU-401 compatibles, IBM Music
Feature card, Key Electronice MIDIator, Creative Labs SOUND BLASTER
(with MIDI adapter).  


Device setup
------------

To run any of these programs in default mode, type one of the program
names listed below.  To select special MIDI device options, include the
-d option on the command line.  The -d option identifies the MIDI
interface(s) in use, and optionally, the IRQ and base I/O address:

             -dmfc      selects IBM Music Feature
             -dmpu      selects MPU-401 compatible
             -dmidiator selects MIDIator
             -dsbmidi   selects SOUND BLASTER MIDI

             (The first 3 letters of the device name are sufficient.)

    The MIDIator cannot be detected automatically and the -dmid option
    must always be specified if one is in use.  

    Optional IRQ and I/O port address information can be added following
    the device id if necessary:

             -dxxx:<irq>:<ioaddr>

    For example, to define an MPU-compatible interface using IRQ 5 and I/O
    address 332 (hex), use:

             -dMPU:5:332

    If only the I/O address is required but the default IRQ is alright,
    use -dMPU::332.

    The irq and ioaddr are not relevant to the MIDIator, though the first
    option number can be given to indicate use of the com port 2 instead of
    the default com 1.  (ex: -dmid:2)

    To set up a device before hand, define the "opt1" environment variable
    to be the -d option that would be included on the command line.  For
    example:
                  set opt1=-dmpu:5:332

    This line would generally be added to the autoexec.bat file to 
    select the option permanently.


Programs included
-----------------

PLAY       Standard MIDI file player - batch or interactive.
           Usage: ** See the file PLAY.HLP **

PLAYB      Small, batch MIDI file player.
           Usage: ** Same as Play batch mode **

PLAYR      Memory resident player.
           Usage: ** See the file PLAYR.DOC **

RECORD     Records standard MIDI files suitable for use by PLAY.
           Usage: ** See the file RECORD.HLP **


All data entry within the Play and Record programs is self-prompting. 
More complete usage information is contained in the help files.  The
names of each interactive program's help files include the program name
and have the extension '.HLP'.  The help files may be viewed within the
programs via the F1 help option on any screen.  They may also be viewed
as normal text files, or printed.  If using an editor to view them, be
careful not to modify them, since they are specially formatted and may
not be viewable within the programs if modified.