.TH timidity 1 "April 25 2004" "2.13.0".SH NAMETiMidity++ \- MIDI\-to\-WAVE converter and player.SH SYNOPSIS.B timidity[options] filename [...].SH DESCRIPTION\fBTiMidity++\fP is a converter that converts some of MIDI files(supported formats: Standard MIDI files (*.mid), Recomposer files(*.rcp, *.r36, *.g18, *.g36) and Module files (*.mod)) into formattedaudio files (e.g. RIFF WAVE).  \fBTiMidity++\fP uses GravisUltrasound\-compatible patch files or Soundfonts (*.sfx, *.sf2) togenerate digital audio data from MIDI files.  The digital audio datagenerated by \fBTiMidity++\fP can be stored in a file for processing,or played in real time through an audio device..brIn real time playing, \fBTiMidity++\fP can show the lyrics containedin KAR or WRD files..SH FILENAMEYou can use the following expressions as the \fIfilename\fP argument:.TP.B \-Read a MIDI file from standard input..TP.B path/filenameRead a MIDI file from the specified path on a filesystem..TP.B dir:directory.br.ns.TP.B directory/Read and play all MIDI files in the specified \fIdirectory\fP.  Forexample,.sp% timidity some/where/.spplays all files in the directory \fBsome/where/\fP..TP.B Archive FileExtract and play the file(s) in the archive.  If you want to specify acertain MIDI file in the archive, append \fB#<MIDI\-filename>\fP tothe archive name.  The path after `#' allows the use of the wildcardexpressions (case insensitive)..brYou can use escape sequence \fB\\xHH\fP, where `HH' is a ASCII numberin hexadecimal integer..spFor example:.RS.TP% timidity file.zip#file.midPlays \fBfile.mid\fP in \fBfile.zip\fP.TP% timidity file.lzh#*.midPlays any files that match the wildcard expression \fB*.mid\fP in\fBfile.lzh\fP.TP% timidity file.tgz#*This expression is the same as \fBfile.tgz\fP.LPSince these mechanism are contained in \fBTiMidity++\fP itself, youcan use this syntax even in the MS Windows environment..sp\fBTiMidity++\fP can handle the following archive formats:.TP.B tar (*.tar).TP.B tar+gzip (*.tar.gz, *.tgz).TP.B zip (*.zip).TP.B lzh (*.lzh, *.lha)(lh0, lh1, lh2, lh3, lh4, lh5, lh6, lz4, lzs and lz5 are available).LPOther archives can be expanded if expander command is specified on thecompile phase.  \fBTiMidity++\fP will pipe that command..RE.TP.B news://news\-server[:port]/Message\-ID.br.ns.TP.B news://news\-server[:port]/newsgroup[/first\-last]Play the MIDI file in the specified article on the news server.  If anewsgroup is specified \fBTiMidity++\fP plays all MIDI files found inany article posted to that newsgroup..br\fBTiMidity++\fP parses MIME Multi\-part messages in case of\fBnews://*\fP scheme, extracts MIDI file that was post to that group,or in case of normal file, you can explicitly handle MIME documents bynaming that file with *.mime extension, or prefix that file with\fBmime:\fP.spThe following MIME\-types are allowed:.RS.TP.B uu\-encoded file\fBbegin\fP.bris required.TP.B base64 encoded\fBContent\-Transfer\-Encoding: base64\fP.bris required.TP.B quoted\-string\fBContent\-Transfer\-Encoding: quoted\-string\fP.bris required.TP.B Mac BinHex formatonly HQX format is available.RE.TP.B http://address.br.ns.TP.B ftp://addressPlay the file specified in the URL..spFor example:.RS.TP% timidity http://www.goice.co.jp/member/mo/dist/midi/impromptu.midplays the specified MIDI\-file directly from the network..LPIf these expression are used in the *.cfg files, you can even usepatch\-files (and others) from remote machines..RE.SH INPUT FILE\fBTiMidity++\fP can handle the following file formats:.TP.B .mid, .rmi (Format 0, 1, 2)Standard MIDI File.TP.B .rcp, .r36, .g18, .g36 (Recomposer formats)Recomposer format which is product for COME ON MUSIC co..TP.B .mfi (MFi Version 3 \- Melody Format for i\-Mode)i\-Mode is Japanese local mobile phone.TP.B .kar (Karaoke format)Displays the lyrics as a Lyric Meta Event message..TP.B .mod, mod.* (Module file).TP.B .wrd (WRD format).SH OPTIONSThe following command line options are accepted by \fBTiMidity++\fP:.TP.BI "\-A " [n][,m](a).br.ns.TP.BI \-\-amplification= n.br.ns.TP.BI \-\-drumpower= m.br.ns.TP.B \-\-[no\-]volume\-compensationMultiplies the master volume by \fIn\fP%.  Default value is 70%.Higher amplification makes louder sounds.  You can specify the drumpower, ratio of drum volume from the other channels.  The allowedvalues of amplification range from \fB0\fP (no sound) to \fB800\fP..brOptionally to put `a' character along with \fB\-a\fP option, or to use\fB\-\-volume\-compensation\fP, instructs \fBTiMidity++\fP toregularize the volume.  You can easily gain dynamic range..spFor example:.RS.TP.B \-A90volume 90%, drum power 100%, compensation is off.TP.B \-A,120volume 70%, drum power 120%, compensation is off.TP.B \-A90,120volume 90%, drum power 120%, compensation is off.TP.B \-Aavolume 70%, drum power 100%, compensation is on.TP.B \-A90avolume 90%, drum power 100%, compensation is on.TP.B \-A,120avolume 70%, drum power 120%, compensation is on.TP.B \-A90,120avolume 90%, drum power 120%, compensation is on.RE.TP.B \-a, \-\-[no\-]anti\-aliasTurns on antialiasing.  Samples are run through a lowpass filterbefore playing, which reduces aliasing noise at low resamplingfrequencies..TP.BI "\-B " n,m ", \-\-buffer\-fragments=" n,mFor the Linux/FreeBSD/OSS/ALSA/Windows sound driver, selects thenumber of buffer fragments in interactive mode.  Increasing the numberof fragments may reduce choppiness when many processes are running.It will make \fBTiMidity++\fP seem to respond sluggishly to fastforward, rewind, and volume controls, and it will throw the statusdisplay off sync.  Specify a fragments number of 0 to use the maximumnumber of fragments available..TP.BI "\-C " n ", \-\-control\-ratio=" nSets the ratio of sampling and control frequencies.  This determineshow often envelopes are recalculated \-\- small ratios yield betterquality but use more CPU time..TP.BI "\-c " file ", \-\-config\-file=" fileReads an extra configuration file..TP.BI "\-D " n ", \-\-drum\-channel=" nMarks channel as a drum channel.  If channel is negative, channel\-\fIn\fP is marked as an instrumental channel.  If \fIn\fP is\fB0\fP, all channels are marked as instrumental..TP.BI "\-d " dir ", \-\-interface\-path=" dirSpecifies the directory containing installed dynamic\-link interfacemodules..TP.BI "\-E " mode ", \-\-ext=" modeSet \fBTiMidity++\fP extend modes.  The following modes are available(capitalized switch means disable this feature):.RS.TP.B w/W, \-\-[no\-]mod\-wheelEnable/disable modulation controlling..TP.B p/P, \-\-[no\-]portamentoEnable/disable portamento controlling..TP.B v/V, \-\-[no\-]vibratoEnable/disable NRPM vibration..TP.B s/S, \-\-[no\-]ch\-pressureEnable/disable channel pressure controlling..TP.B e/E, \-\-[no\-]mod\-envelopeEnable/disable modulation envelope controlling..TP.B t/T, \-\-[no\-]trace\-text\-metaEnable/disable tracing all Text Meta Events..TP.B o/O, \-\-[no\-]overlap\-voiceAccept/reject pronouncing multiple same notes..TP.B z/Z, \-\-[no\-]temper\-controlEnable/disable MIDI Tuning Standard temperament controlling..TP.BI m HH ", \-\-default\-mid=" HHSets the manufacturer ID to \fIHH\fP (where \fIHH\fP are twohex\-digits)..br\fIHH\fP values of \fBGS/gs\fP, \fBXG/xg\fP or \fBGM/gm\fP areunderstood as \fB41\fP, \fB43\fP and \fB7e\fP respectively..TP.BI M HH ", \-\-system\-mid=" HHSets the system manufacturer ID to \fIHH\fP (where \fIHH\fP are twohex\-digits)..brIn this option, the manufacuture ID is set unchangable. ManufacutureID from the input file would be ignored..TP.BI b n ", \-\-default\-bank=" nUse tone bank \fIn\fP as the default..TP.BI B n ", \-\-force\-bank=" nSets the bank number of all channels to \fIn\fP..TP.BI i n[/m] ", \-\-default\-program=" n[/m]Use the program number as the default instrument.  Any Program Changeevents in MIDI files will override this option..brIf \fIn\fP is followed by \fI/m\fP the default program number of thechannel \fIm\fP is specified by \fIn\fP..TP.BI I n[/m] ", \-\-force\-program=" n[/m]Similar to \fB\-Ei\fP but this ignores all program changes..TP.BI "F " argsFor effects.  See below.  In \fIargs\fP option, you can specifyfollowing effect options:.RS.TP.BI delay= (d|l|r|b)[,msec] ", \-\-delay=" (d|l|r|b)[,msec]Sets delay type..RS.TP.B d, 0Disabled delay effect..TP.B l, 1Left delay..TP.B r, 2Right delay..TP.B b, 3Swap left & right..LPOptional \fImsec\fP is the delay time..RE.TP.BI chorus= (d|n|s)[,level] ", \-\-chorus=" (d|n|s)[,level].RS.TP.B d, 0Disable this effect..TP.B n, 1Enable MIDI chorus effect control..TP.B s, 2Surround sound, chorus detuned to a lesser degree (default)..LPThe optional parameter \fIlevel\fP specifies the chorus level \fB0\fPto \fB127\fP..RE.TP.BI reverb= (d|n|g|f|G)[,level] ", \-\-reverb=" (d|n|g|f|G)[,level].RS.TP.B d, 0Disable MIDI reverb effect control..TP.B n, 1Enable MIDI reverb effect control.  This effect is only available instereo..TP.B g, 2Global reverb effect..TP.B f, 3Freeverb MIDI reverb effect control (default)..TP.B G, 4Global freeverb effect..LPThe optional parameter \fIlevel\fP specifies the reverb level \fB0\fPto \fB127\fP..RE.TP.BI vlpf= (d|c|m) ", \-\-voice\-lpf=" (d|c|m).RS.TP.B d, 0Disable LPF effect..TP.B c, 1Chamberlin resonant LPF (12dB/oct) (default)..TP.B m, 2Moog resonant low\-pass VCF (24dB/oct).RE.TP.BI ns= n ", \-\-noise\-shaping=" nEnable the \fIn\fP th degree noiseshaping filter.  The distortion atdecay stage is improved, but the noise on human auditory feelingincreases because it shifts to a high frequency.  In case of 8\-bitlinear encoding, valid values of \fIn\fP are in the interval from\fB0\fP (min) to \fB4\fP (max).  Default value is \fB4\fP.  In case of16\-bit linear encoding, valid values of n are in the interval from\fB0\fP to \fB4\fP.  According to the value, it works as following.Default value is \fB4\fP..RS.TP.B 0No noise shaping..TP.B 1Traditional noise shaping..TP.B 2Overdrive-like soft-clipping + new noise shaping..TP.B 3Tube-amplifier-like soft-clipping + new noise shaping..TP.B 4New noise shaping..RE.TP.BI resamp= (d|l|c|L|n|g) ", \-\-resample=" (d|l|c|L|n|g).RS.TP.B d, 0No interpolation..TP.B l, 1Linear interpolation..TP.B c, 2Cubic spline interpolation..TP.B L, 3Lagrange method..TP.B n, 4Newton polynomial interpolation..TP.B g, 5Modified Gauss effect (default)..LPThis option affects the behavior of \fB\-N\fP option..RE.RE.RE.TP.B \-e, \-\-evilMake \fBTiMidity++\fP evil.  For the Win32 version, this increases thetask priority by one.  It can give better playback when you switchtasks at the expense of slowing all other tasks down..TP.B \-F, \-\-[no\-]fast\-panningTurns on fast panning to accommodate MIDI pieces that expect panningadjustments to affect notes that are already playing.  Some files thatdon't expect this have a habit of flipping balance rapidly betweenleft and right, which can cause severe popping when the \fB\-F\fP flagis used..brIn the current version of \fBTiMidity++\fP this option is a toggle..TP.B \-f, \-\-[no\-]fast\-decayToggles fast envelopes.  This option makes \fBTiMidity++\fP faster butthe release time of the notes are shortened..TP.BI "\-g " sec ", \-\-spectrogram=" secOpen the Sound\-Spectrogram window.  This option is activated if thesystem has support for the X Window System..TP.BI "\-H " n ", \-\-force\-keysig=" nSpecify the number of key signature.  MIDI file is performed withtransposition to the key of the number of sharp (when \fIn\fP ispositive) or flat (when \fIn\fP is negative).  Valid values of \fIn\fPare in the interval from \fB\-7\fP to \fB7\fP.  For example, if \fIn\fPis \fB1\fP, MIDI file with any tonality will be performed transposingto \fB1\fP flat (i.e., F major or D minor).  Therefore, it isconvenient to use for the accompaniment when practicing a musicalinstrument by the tonality which is easy to perform..TP.B \-h, \-\-helpShow the help message..TP.BI "\-i " mode ", \-\-interface=" mode.br.ns.TP.BI \-\-realtime\-priority= n.br.ns.TP.BI \-\-sequencer\-ports= nSelects the user interfaces from the compiled\-in alternatives.\fImode\fP must be begun with one of the supported interfaceidentifiers.  Run \fBTiMidity++\fP with the \fB\-h\fP option to see alist..brFor ALSA sequencer interface, optionally to use\fB\-\-realtime\-priority\fP, set the realtime priority by \fIn\fP,and to use \fB\-\-sequencer\-ports\fP, set the number of openedsequencer ports.  Default value is \fB4\fP..brThe following identifiers may be available:.RS.TP.B \-iddumb interface.TP.B \-inncurses interface.TP.B \-isS\-Lang interface.TP.B \-iaX Athena Widget interface.TP.B \-ikTcl/Tk interface.TP.B \-imMotif interface.TP.B \-iTvt100 interface.TP.B \-ieEmacs interface.br(use ``M\-x timidity'' in Emacs).TP.B \-iiskin interface.brEnvironment variable \fBTIMIDITY_SKIN\fP must be set to the path ofthe skin data (compressed data are also supported)..TP.B \-igGTK+ interface.TP.B \-irLaunch \fBTiMidity++\fP as MIDI server..TP.B \-iALaunch \fBTiMidity++\fP as ALSA sequencer client..TP.B \-iWWindodws synthesizer interface.TP.B \-iwWindodws GUI interface.TP.B \-iPPortMIDI synthesizer interface.TP.B \-ipUMP interface.TP.B Interface optionsOption characters may be added immediately after the interfaceidentifier.  The following options are recognized:.RS.TP.BI "v, \-\-verbose=" nIncreases verbosity level.  This option is cumulative..TP.BI "q, \-\-quiet=" nDecreases verbosity level.  This option is cumulative..TP.B t, \-\-[no\-]traceToggles trace mode.  In trace mode, \fBTiMidity++\fP attempts todisplay its current state in real time.  For the Linux sound driver,this is accomplished through the use of short DMA buffer fragments,which can be tuned via the \fB\-B\fP option..TP.B l, \-\-[no\-]loopLoop playing (some interfaces ignore this option).TP.B r, \-\-[no\-]randomRandomize file list arguments before playing.TP.B s, \-\-[no\-]sortSort file list arguments before playing.TP.B D, \-\-[no\-]backgroundDaemonize \fBTiMidity++\fP in background (for alsaseq only).RE.RE.TP.B \-j, \-\-[no\-]realtime\-loadEnable the loading of patch files during play..TP.BI "\-K " n ", \-\-adjust\-key=" nAdjusts key (i.e., transposes the song) by \fIn\fP half tones.  Rangesfrom \fB\-24\fP to \fB24\fP..TP.BI "\-k " msec ", \-\-voice\-queue=" msecSpecify audio queue time limit to reduce voices.  If the remainingaudio buffer is less than \fImsec\fP milliseconds, \fBTiMidity++\fPtries to kill some voices.  This feature makes it possible to playcomplicated MIDI files on slow CPUs.  Setting \fImsec\fP to zero tells\fBTiMidity++\fP to never remove any voices..TP.BI "\-L " path ", \-\-patch\-path=" pathAdds \fIpath\fP to the library path.  Patch, configuration, and MIDIfiles are searched along this path.  Directories added last will besearched first.  Note that the current directory is always searchedfirst before the library path..TP.BI "\-M " name ", \-\-pcm\-file=" name\fBTiMidity++\fP can play a PCM file instead of a MIDI file.  If``auto'' is specified, \fBTiMidity++\fP tries to open foo.mid.wav orfoo.mid.aiff when playing foo.mid.  If ``none'' is specified, thisfeature is disabled.  Otherwise just plays \fIname\fP..TP.BI "\-m " msec ", \-\-decay\-time=" msecModify envelope volume decay time.  \fImsec\fP is the minimum numberof milliseconds to sustain a sustained note..RS.TP.BI \-m 0Disable sustain ramping, causes constant volume sustains (default)..TP