jazz - a midi sequencer for Linux and M$-Windows

For latest infos look at http://www.jazzware.com
There is a mailing list, send a mail with subject-field containing
	subscribe
to jazz-users-request@hia.no to get on the list. We'd be happy to
receive your bugreports (well, somehow) or success stories.

enjoy,
	Andreas and Per



** Note: The rest of this file is relevant for Unix (Linux) users only.

Binary distribution (JAZZ++ version 3.x, MIDI + AUDIO, motif)
=============================================================

What midi driver to use?
------------------------
The Linux version of JAZZ can talk to two kinds of midi drivers:

1. The OSS drivers (comes with the Linux kernel)
2. The JAZZ-native MPU-401 driver

We recommend you use the OSS drivers, as they support a lot of
different midi-interfaces and sound-cards. OSS also offers the audio
drivers used by JAZZ++.

For users equipped with a fully MPU-401 compatible midi interface card
(intelligent mode), the native jazz MPU-401 driver can offer special
MPU-401 features (like external sync) not yet implemented for OSS as well
as TCP communication between the sequencer and the driver.

If you don't have any soundcard, jazz can be used as midi editor without
record/play ability.


Installation for OSS drivers (Linux built-in midi/audio drivers)
----------------------------------------------------------------
Preparations:

* Be sure that your kernel supports midi sequencer

* To play midi you need to have an 'external' midi device attached
  (playmidi -e has to work).

* For audio operation you also need kernel audio support.

* For audio/midi synchronization to work you need a kernel that supports
  the ioctl SNDCTL_SEQ_GETTIME. This is supported on kernels later than
  2.1.28, but may be incorporated into the 2.0.29 kernel by applying the
  supplied patch file (linux/kernel-2.0.29.patch) and recompiling the
  kernel.

Installation:

* As root run the installation script install-jazz, that comes with
  this distribution. This will install jazz to /usr/local/jazz

* Make sure that the environment variable JAZZ points to /usr/local/jazz
  When using sh or bash add the lines"
	JAZZ=$DEST
	export JAZZ
  to your .profile or .bashrc. When using csh add the line
	setenv JAZZ $DEST
  to your .cshrc

* Read the HTML documentation by pointing your Netscape to
  /usr/local/jazz/doc/html/jazz_contents.html


Installation for jazz's native mpu-401 driver
---------------------------------------------
* You need a kernel with tcp/ip support and NO soundcard support
  installed.

* cd to drivers/linux. Edit the file mpu.h and set IO-Port and
  IRQ of your midi card. The factory defaults are IOBASE 0x330 and IRQ
  9. Run make and copy the resulting mpu.o to /usr/src/linux/modules
  (or where your modules reside).

* cd to midinetd and run make. Copy the resulting midinetd to 
  /usr/local/sbin/.

* Add a line
      midinet 40001/tcp    midinetd
  to your /etc/services and
      midinet stream tcp nowait root /usr/local/sbin/midinetd in.midinetd
  to /etc/inetd.conf.
  Send a HUP signal to your inetd or reboot to make changes take effect.

* Make a device file for the mpu401 driver with the command
      mknod /dev/mpu401 c 13 0

* Load the mpu driver into the kernel with the command
      insmod mpu
  as root. You may want to put this command into your /etc/rc.d/rc.local
  to have everything ready after reboot.

* Install jazz as described for the OSS driver

* Edit /usr/local/jazz/jazz.cfg and set
      .driver 0
  The .device entry is ignored when using jazz's mpu driver.


Install documentation
---------------------
For 'help-buttons' to work (Note: no graphics support):
  * Copy jazz.xlp to /usr/local/bin
  * Be sure you have a 'wxhelp' executable installed (can be downloaded
    from JazzWare; http://www.jazzware.com)

For HTML documentation (nice graphics):
  * Open file doc/jazz_contents.html from your favourite html browser

For postscript documentation (graphics here too):
  * Get file jazz.ps from JazzWare (http://www.jazzware.com)


Other initialization
--------------------
For some soundcards you may have to download
samples/patches into your soundcard before starting jazz.  Programs
for this may be found in the packages glib, adagio, playmidi and
snd-data-?.?.tar.gz and maybe others.



