======================================================================	TiMidity++ Installation guide					Masanao Izumo					<iz@onicos.co.jp>					Mar.01.2004					version 2.13.0 or later======================================================================This document describes how to install TiMidity++ for your UNIX-likemachine.You can configure and make timidity.exe on the Cygwin environment ofWindows 95/98/Me/NT/2000/XP/2003.  If you are in Windows, installCygwin (or mingw) if you do not have them.Today's Macintosh has FreeBSD userland, so things described here wouldfly.  Methods for older Macintosh ("Classic") are not described here.======================================================================Basic Installation======================================================================TiMidity++ uses GNU autotools to build.  So the simplest way tocompile this package is:1. "cd" to the directory containing TiMidity++'s source code and type   "./configure" to configure the package for your system.  If you are   using csh on an old version of System V, you might need to type   "/bin/sh configure" instead to prevent csh from trying to execute   configure itself.  Running configure takes a while.  While running,   it prints some messages telling which features it is checking for.2. Type "make" to compile the package.   NOTE: this make method requires GNU make.  So if your system has it         as gamke, type "gmake" instead.3. Type "make install" to install the programs and any data files and   documentation.======================================================================More complecated way======================================================================The full installation process is:1. configre2. edit common.makefile, Makefile, timidity.h if necessery3. make4. installation5. set up voice dataEach processes are explained in following sections.  Note that % isthe shell prompt.======================================================================Configure======================================================================First, execute the following command:% /bin/sh configure --helpMany options of configure will be displayed.  Most of them, such as--help, --prefix=PREFIX, and so on are the regular ones.  They exisitson most package that uses autoconf and you do not have to worry abouttheir behavior.There also exists some options that is typical to TiMidity++.  Main ofthese are the following:--enable-debug  Enables debug.  Things will be compiled with debugging methods/  informations.--without-x  TiMidity++ uses X by default.  So you must specify this option to  prevent linker from linking X libraries.--enable-audio[=audio_list]  Enables TiMidity++ to play MIDI files.  If --enable-audio=no,  TiMidity++ acts as a MIDI-to-WAVE converter.  You can specify one or more audio-device listed below.  * default: Automatically select audio device.  * oss: OSS /dev/dsp  * sun: SunOS /dev/audio  * hpux: hp-ux /dev/audio  * irix: IRIX audio library  * mme: OSF/1 MME  * sb_dsp: BSD/OS 2.0 /dev/sb_dsp  * w32: Windows MMS  * darwin: darwin(Mac OS X)'s CoreAudio frameowrk  * alsa: ALSA pcm device  * alib: hp-ux network audio (Alib)  * nas: NAS  * portaudio: PortAudio  * jack: JACK  * arts: aRts  * esd: EsounD  * vorbis: ogg vorbis  * gogo: mp3 Gogo-No-Coder (Windows only)--enable-interface[=interface_list]--enable-dynamic[=interface_list]  Specify which interface to use.  If you use --enable-dynamic instead  of --enable-interface, the interfaces specified will be linked  dynamically and the binary size would become a bit smaller.  You can select one or more interfaces listed below.  * ncurses: ncurses interface.  * slang: S-Lang interface.  * motif: Motif interface.  Motif interface also works under Lestiff.  * tcltk: Tcl/Tk interface.  * emacs: Emacs front-end.  Type M-x timidity to invoke.  * vt100: The full-screen interface using vt100 terminal control codes.  * xaw: X Athena Widget interface.  * xskin: X skin interface.  * gtk: GTK+ interface.  * w32gui: Build as Windows GUI binary.  * winsyn: Build as TiMidity++ Windows Synthesizer server.  * alsaseq: Build as ALSA sequencer client.  Note that  --enable-interface=INTERFACE1,INTERFACE2,...  equals as  --enable-INTERFACE1=yes --enable-INTERFACE2=yes ...  and for the same way,  --enable-dynamic=INTERFACE1,INTERFACE2,...  equals as  --enable-INTERFACE1=dynamic --enable-INTERFACE2=dynamic ...--enable-network  Enables network support.  This will allow TiMidity++ to open a MIDI  file via network.  You can specify the location of MIDI files by  http://foo.com.tw/bar/baz.mid - like format.--enable-spectrogram  With this option specified, TiMidity++ can open a window on X and  show sound-spectrogram there.--enable-wrd  WRD is a Japanese local lyric-contents format.  This option enables  WRD interface.* Environment variables and flags to pass to configureSome MIDI files eat too much CPU power.  If you choose correctoptimizing method, TiMidity++ can play such MIDI files smoothly.You can tell configure which optimizing method to use by followingenvironmental variables:CC  the C compiler command e.g. "/usr/bin/gcc"CFLAGS  flags to pass to ${CC} e.g. "-O2 -pipe"LDFLAGS  flags to pass to linker e.g. "-L/usr/gnu/lib"CPPFLAGS  flags to pass to preprocessor e.g. "-traditional-cpp"Your compiler may have many optimization flags.  For example, in caseof ultrasparc/gcc, you can specify:% env CFLAGS='-O3 -Wall -mv8 -funroll-all-loops -fomit-frame-pointer \	-mcpu=ultrasparc' /bin/sh configure [configure-options]...and the binary will (hopefully) run faster.======================================================================Edit some files======================================================================If make fails, or if you want to change some parameters, editcommon.makefile, Makefile, or timidity.h manually.* Parameters in timidity.hThere are some options that are hard-coded into timidity binary.  Theyare # define-ed in timidity.h.  You have to change things there if youwant to change these flags.** CONFIG_FILEEdit CONFIG_FILE to your convenience.  By default,#define CONFIG_FILE DEFAULT_PATH "/timidity.cfg"are recommended.  DEFAULT_PATH is the same as TIMID_DIR in Makefile.If you want to place it to another path, specify as the following:#define CONFIG_FILE "/etc/timidity.cfg"** DECOMPRESSOR_LISTThe file extractor (please ignore in Windows).  By default:#define DECOMPRESSOR_LIST { \		".gz", "gunzip -c %s", \		".bz2", "bunzip2 -c %s", \		".Z", "zcat %s", \		".zip", "unzip -p %s", \		".lha", "lha -pq %s", \		".lzh", "lha -pq %s", \		".shn", "shorten -x %s -", \		0 }TiMidity++ can handle some of archive format directly.  But otherformat will use this extractor.** PATCH_CONVERTERSConfiguration of of patch file converter (please ignore in Windows).By default:#define PATCH_CONVERTERS { \		".wav", "wav2pat %s", \		0 }** PATCH_EXT_LISTConfiguration of extensions of GUS/patch file.  If specified in thisconfiguration, the extension can omit in all *.cfg.  By default:#define PATCH_EXT_LIST { \		".pat", \		".shn", ".pat.shn", \		".gz", ".pat.gz", \		".bz2", ".pat.bz2", \		0 }** DEFAULT_PROGRAMConfiguration of default instrument.  By default:#define DEFAULT_PROGRAM 0If no Program Change event, this program name are adopted.  Usually 0is Piano.** DEFAULT_DRUMCHANNELSConfiguration of drum channel.  By default:#define DEFAULT_DRUMCHANNELS {10, -1}Numbers are the list of drum channels, and -1 is the terminator.  Forexample, if you wish to default drum channel be 10 and 16,#define DEFAULT_DRUMCHANNELS {10, 16, -1}This channel can change in command line option.** FLOAT_TType of floating point number.  Choose one of these:* typedef double FLOAT_T;* typedef float FLOAT_T;Many machine which has FPU results faster operations with double thanthat with float.  But some machine results contrary.** (MAX|MIN)_OUTPUT_RATEMinimum/maximum range of playing sample rate.  By default:#define MIN_OUTPUT_RATE 4000#define MAX_OUTPUT_RATE 65000** DEFAULT_AMPLIFICATIONDefault value of master volume.  By default:#define DEFAULT_AMPLIFICATION 70This number is the percentage of max volume.  This default value willbe nice in any occasions.  This number can specify in command lineoption (-A).** DEFAULT_RATEDefault sampling rate.  By default:#define DEFAULT_RATE 44100If you have much CPU power, DAT quality GUS/patch and want to listenfunny sound,#define DEFAULT_RATE 48000is good solution.** DEFAULT_VOICESConfiguration of default polyphony numbers.  By default:#define DEFAULT_VOICES 256DEFAULT_VOICE is the polyphony number in boot-time.  This value isconfigurable by the command line option (-p) from 1 to until memory isallowed.  If your machine has much CPU power,#define DEFAULT_VOICES 512enables good harmony.** AUDIO_BUFFER_BITSSize of internal buffer.  By default: