timidity.cfg - configure file of TiMidity++
SYNOPSIS
/etc/timidity.cfg
/usr/local/share/timidity/timidity.cfg
DESCRIPTION
The file timidity.cfg describes the runtime environments
of timidity(1) that are the path of sound font, instru
ments configrations or else.
TiMidity looks for the configuration file timidity.cfg at
startup, before processing any options. If it can't be
accessed, and the library path is changed with a -L option
on the command line, then the default file will be sought
again along the new library path after processing all
options, unless another configuration file was specified
with the -c option.
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.
FORMAT
Following statements can be used in a configuration file:
dir directory
Adds directory to the search path in the same man
ner as the -L command line option.
EXAMPLES
Archive file are also allowed. For example:
dir /usr/local/share/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/share/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 exam
ple the patch files bar.pat, baz.pat and zoo.pat contained
in the foo.zip are also installed.
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 ampli
fication percent. If no value is specified,
one will be automatically determined when
ever 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 spec
ified in the configuration file, the default
in the patch file will be used.
pan=panning
Sets the instrument's default panning. pan
ning may be left, right, center, or an nte
ger 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
keep={loop|env}
By default, percussion instruments have
their loop and envelope information
stripped. Strangely shaped envelopes are
removed automatically from melodic instru
ments as well. keep can be used to prevent
stripping envelope or loop data. For exam
ple, 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 informa
tion 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 TiMid
ity.
#extension altassign program1 program2 ...
Sets the alternate assign for drum set. For exam
ple, 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 indi
cater 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
#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 omit it.
If any file-name expression ended with character '|'
(Ascii 0x7c), the file-name is treated as command and out
puts of the command are also examined as arguments of
statements.
SEE ALSO
timidity(1), lsmidiprog(1), mididump(1), patinfo(1),
sf2text(1), wav2pat(1)
Copyright (C) 1999 Masanao Izumo <mo@goice.co.jp> Copy
right (C) 1995 Tuukka Toivonen <tt@cgs.fi>
Original version was developed under the name of Tuukka
Toivonen <tt@cgs.fi> until the version of TiMidity-0.2i.
His development was discontinued because of his busy work.
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
You should have received a copy of the GNU General Public
License along with this program; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
02139, USA.
AVAILABILITY
The latest release is available on the TiMidity++ Page,
URL http://www.goice.co.jp/member/mo/timidity/
Man(1) output converted with
man2html