MAN page from RedHat 8.X timidity++-2.11.3-4.i386.rpm


Section: File Formats (5)
Updated: Nov 24 1998


timidity.cfg - configure file of TiMidity++






The file timidity.cfg describes the runtime environments of timidity(1) that are the path of sound font, instruments configrations or else.
TiMidity looks for the configuration file timidity.cfg atstartup, before processing any options. If it can't beaccessed, and the library path is changed with a -L optionon the command line, then the default file will be soughtagain along the new library path after processing alloptions, unless another configuration file was specifiedwith the -c option.

Configuration files define the mapping of MIDI programs toinstrument files. Multiple files may be specified, andstatements in later ones will override earlier ones.



Following statements can be used in a configuration file:

dir directory
Adds directory to the search path in the same manneras the -L command line option.


Archive file are also allowed. For example:
dir /usr/local/share/timidity/inst/

1 baz.pat
2 zoo.pat
0 bar.pat

At first, dir specities the archive name (followed by '#') for thepath of patch files same as directory name (in this case ,"/usr/local/share/timidity/inst/").TiMidity recognize the path is an archive file if the expression hasthe last character '#', and also read the files contained in thisarchive file.In previouns example the patch files bar.pat, baz.pat and zoo.patcontained in the are also installed.

source file
Reads another configuration file, then continuesprocessing the current one.

bank number
Selects the tone bank to modify. Patch mappingsthat follow will affect this tone bank.

progbase number
Sets and displays the tone number from number to number+128.If progbase 1 are specified, tone numbers that follow are settedand displayed as the numbers from 1 to 128.

drumset number
Selects the drum set to modify. Patch mappingsthat follow will affect this drum set.

number file [options]
Specifies that the the MIDI program number in thecurrent tone bank or drum set should be playedusing the patch file. options may be any of thefollowing:

Amplifies the instrument's volume by amplificationpercent. If no value is specified,one will be automatically determined wheneverthe instrument is loaded.

Specifies a fixed MIDI note to use whenplaying the instrument. If note is 0, theinstrument will be played at whatever notethe Note On event triggering it has. Forpercussion instruments, if no value is specifiedin the configuration file, the defaultin the patch file will be used.

Sets the instrument's default panning. panningmay be left, right, center, or annteger between -100 and 100, designatingfull left and full right respectively. Ifno value is specified, the default in thepatch file will be used. Note that panningcontrols in MIDI files will override thisvalue.

By default, percussion instruments havetheir loop and envelope informationstripped. Strangely shaped envelopes areremoved automatically from melodic instrumentsas well. keep can be used to preventstripping envelope or loop data. For example,the Short and Long Whistle percussioninstruments (General Midi numbers 71 and 72)need to have `keep=loop keep=env' specifiedin the configuration file.

Force removal of loop or envelope information from all patches in the instrument, orstrip the tail, i.e. all data after theloop. Some third-party instruments havegarbage after the loop, as evidenced by aclicking noise whenever the instrument isplayed, so adding the strip=tail option willmarkedly improve sound quality.

The following statements are available only latest TiMidity.

#extension altassign program1 program2 ...
Sets the alternate assign for drum set.For example, if you want to pronounce Hi-Hat cymbals (note number 42/44/46)in the drumset 0 exclusively to each others, specify:

drumset 0
altassign 42 44 46

Note that alternate assign of drumset 0 is used by default.

#extension comm program secound
Specifies the comment comment for the tone number program.These comments are displayed in the indicater line at the caseTiMidity is booted with option -int, -iTt.

#extension timeout program secound
Specifies the time-out value of the program. If any notespronounced with the tone number program are suspendedmore than second seconds, TiMidity kills the notes.

#extension copydrumset drumset
Copies all settings of the drumset to the current drumset.

#extension copybank bank
Copies all settings of the bank to the current bank.

#extension HTTPproxy hostname:port
Specifies the proxy of the HTTP protocol. hostname and port are of the proxy host's.

#extension FTPproxy hostname:port
Specifies the prox of the FTP protocol. Same as HTTP.

#extension mailaddr your-mail-address
Specifies user's mail address. This address is sended to the FTP server if TiMidity access any file via FTp.

#extension opt [-]{option} [optarg]
Sets the value of boot-time options.

#extension undef progno
Undefine the tone progno of current tone bank.

These "#extension" statements are beginning with character '#' that is the comment flag of old TiMidity(version 0.2i or earlier).So these statememts are treated as comment line.
The latest TiMidity treats "#extension" as white-space. So you can omitit.

If any file-name expression ended with character '|' (Ascii 0x7c),the file-name is treated as command and outputs of the commandare also examined as arguments of statements.



timidity(1), lsmidiprog(1), mididump(1), patinfo(1), sf2text(1), wav2pat(1)



Copyright (C) 1999 Masanao Izumo <>Copyright (C) 1995 Tuukka Toivonen <>Original version was developed under the name of Tuukka Toivonen<> until the version of TiMidity-0.2i. His development wasdiscontinued because of his busy work.This program is free software; you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe Free Software Foundation; either version 2 of the License, or (atyour option) any later version.This program is distributed in the hope that it will be useful, butWITHOUT ANY WARRANTY; without even the implied warranty ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNUGeneral Public License for more details.You should have received a copy of the GNU General Public Licensealong with this program; if not, write to the Free SoftwareFoundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA



The latest release is available on the TiMidity++ Page,




This document was created byman2html,using the manual pages.