Configuration files define the mapping of MIDI programs to
instrument files. Multiple files may be specified, and
statements in later ones will override earlier ones.
- dir directory
-
Adds directory to the search path in the same manner
as the -L command line option.
Archive file are also allowed. For example:
dir /usr/local/lib/timidity/inst/foo.zip#
1 baz.pat
2 zoo.pat
0 bar.pat
At first, dir specities the archive name (followed by '#') for the
path of patch files same as directory name (in this case ,
"/usr/local/lib/timidity/inst/foo.zip").
TiMidity recognize the path is an archive file if the expression has
the last character '#', and also read the files contained in this
archive file.
In previouns example the patch files bar.pat, baz.pat and zoo.pat
contained in the foo.zip are also installed.
- source file
-
Reads another configuration file, then continues
processing the current one.
- bank number
-
Selects the tone bank to modify. Patch mappings
that 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 setted
and displayed as the numbers from 1 to 128.
- drumset number
-
Selects the drum set to modify. Patch mappings
that follow will affect this drum set.
- number file [options]
-
Specifies that the the MIDI program number in the
current tone bank or drum set should be played
using the patch file. options may be any of the
following:
-
- amp=amplification
-
Amplifies the instrument's volume by amplification
percent. If no value is specified,
one will be automatically determined whenever
the instrument is loaded.
- note=note
-
Specifies a fixed MIDI note to use when
playing the instrument. If note is 0, the
instrument will be played at whatever note
the Note On event triggering it has. For
percussion instruments, if no value is specified
in the configuration file, the default
in the patch file will be used.
- pan=panning
-
Sets the instrument's default panning. panning
may be left, right, center, or an
nteger between -100 and 100, designating
full left and full right respectively. If
no value is specified, the default in the
patch file will be used. Note that panning
controls in MIDI files will override this
value.
- keep={loop|env}
-
By default, percussion instruments have
their loop and envelope information
stripped. Strangely shaped envelopes are
removed automatically from melodic instruments
as well. keep can be used to prevent
stripping envelope or loop data. For example,
the Short and Long Whistle percussion
instruments (General Midi numbers 71 and 72)
need to have `keep=loop keep=env' specified
in the configuration file.
- strip={loop|env|tail}
-
Force removal of loop or envelope information
from all patches in the instrument, or
strip the tail, i.e. all data after the
loop. Some third-party instruments have
garbage after the loop, as evidenced by a
clicking noise whenever the instrument is
played, so adding the strip=tail option will
markedly 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
- #extension comm program secound
-
Specifies the comment comment for the tone number program.
These comments are displayed in the indicater line at the case
TiMidity is booted with option -iNt, -iTt.
- #extension timeout program secound
-
Specifies the time-out value of the program. If any notes
pronounced with the tone number program are suspended
more 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 [-]{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 omit
it.
If any file-name expression ended with character '|' (Ascii 0x7c),
the file-name is treated as command and outputs of the command
are also examined as arguments of statements.