---------------------------------*-text-*---------------------------------

    TiMidity -- Experimental MIDI to WAVE converter
    Copyright (C) 1995 Tuukka Toivonen <titoivon@snakemail.hut.fi>

--------------------------------------------------------------------------

	INSTALLATION INSTRUCTIONS

--------------------------------------------------------------------------

	You need at least the source distribution ("timidity-0.2d.tar.gz"
or later).  If you don't have any GUS-compatible patches or MIDI files,
you should also get "timidity-lib-0.1.tar.gz", which contains Dustin
McCartney's excellent acoustic piano and nylon guitar patches, and some
sample MIDI files.  When you've unpacked both archives, change into the
directory "timidity" and follow the four easy steps:


(1)	Check the options in the Makefile and config.h and say:

		make

	If timidity won't compile, check paths to headers and libraries,
	edit the Makefile appropriately, and try again. Note that you'll
	need ncurses to build the ncurses interface. 


(2)	Adjust audio volume to a comfortable level and say:

	Linux/FreeBSD:

		./timidity -OdM -s22 midi/impromptu.mid

	HP-UX (you need to be running the HP network audio server):

		./timidity -OdM -s22 -o`hostname` midi/impromptu.mid

	SunOS:

		./timidity -OdM -s22050 midi/impromptu.mid

	System without audio driver (a 2,335,998-byte, 8-kHz uLaw file
	"output.au" will be generated):

		./timidity -OrMU -s8 -o output.au midi/impromptu.mid

	You should get a rendition of Chopin's Fantasie Impromptu.  
	If not, and you're running Linux, try making noise with some
	other software to make sure your sound hardware is working
	properly. On systems other than Linux, you may need to fiddle
	with the options -- these examples are untested :) Let me know
	what works.

	If you get choppy sound, make sure TiMidity is getting enough CPU
	time. You can try using a lower sampling rate (the -s option).


(3)	When you've got a working executable, you can check the target
	directories in the Makefile, become root if necessary, and say:

		make install.all

	to install the executable, the manual page, and the support files
	(patches and MIDI examples) in the directories specified. If you
	don't wish to install the support files, you can say:

		make install.bin install.man

	to install just the executable and the manual page.



(4)	Now you can play around with the options to get the best sound
	quality. 

		timidity -h

	will get you a brief list. More detailed information is available
	in the manual page. Also, check out the FAQ for pointers to more 
	instruments and MIDI files.
