Command line options are described below.
(make sure to precede them with a dash (``-''))
-hang -width 8
Fl 8
force the use of 8-bit patches with the gravis ultrasound
to conserve memory. Patches are automatically reloaded as
8-bit when memory runs out, but if you know in advance, you can
save a step and speed up the loading process.
Fl c#
set the channel mask (in hexidecimal) of which channels to
play from the midi file. This is useful if you have a midi file
with some channels that don't sound very good on your hardware.
Fl d
ignore any drum (percussion) tracks in a midi file. (See also
m#
). This is useful for FM or any other hardware where percussion
sounds especially bad. Also useful for midi files where the
percussion is poorly written.
Fl e
send output to external midi. This is what you'll want to do
if you have any midi hardware connected to your system. This
option is the default for playmidi as distributed.
Fl f
send output to fm synth using fm patches. You'll need to use
this option to playback on any non-midi soundcard with the
exception of the gravis ultrasound.
Fl 4
send output to fm synth using 4-op OPL/3 patches (BROKEN!)
Don't use this option since it doesn't work yet.
Fl g
send output to Gravis Ultrasound. If you have a gravis ultrasound
without anything connected to the midi port, this option is for you.
Fl E#
set mask of channels to always output to external midi. If you want
to use more than one playback device, this option allows you to specify
what channels to send to the external midi port. For example,
00FF would send channels 1 - 8 to external midi.
Fl F#
set mask of channels to always output to fm. Used as above.
Fl G#
set mask of channels to always output to gus. Used as above.
Fl i#
set the channel mask (in hexidecimal) of which channels to
ignore from the midi file. This option is good for midi files
with a few channels you don't want to listen to.
Fl m#
set the channel mask (in hexidecimal) of which channels to
consider percussion channels. See also
d
This option is good for midi files that don't conform to the
default percussion arrangement of playmidi. GM standard specifies
percussion in channel 10 only. Some files disobey that requiring
this setting.
Fl o#
forces output to a given synth number (0-4). This option is old
and obsolete. Don't use it. It's probably been removed by the
time you read this.
Fl p[chan,]prog[,chan,prog...]
forces a given program number (1-128) to be used for all output
on given channel, or if no channel is specified, program will
be used for all channels. For example:
p33
sets all channels to program 33,
p5,124
sets just channel 5 to program 124, and
p1,33,2,55,9,22,10,17
sets channel 1 to program 33, channel 2 to program 55, channel 9
to program 22, and channel 10 (percussive) to use the Power Drum Set.
If you're using a Waveblaster, you'll want to use
p10,129
to set channel 10 to playback percussion. You should quote arguments to
p
if you want to include whitespace between them.
Fl I
shows a list general midi programs and numbers. This is intended to
make it easier to use the above option.
Fl t#
skews tempo by a factor (float). This is good for files you think
the author wrote too slow or two fast. Also good if you want to listen
to lots of files at high-speeds, or play a file at slow speeds in order
to learn to play a song on some instrument (like piano).
Fl r
real time ansi (25-line) playback graphics tracking of all
notes on each channel and the current playback clock.
This flag is assumed when using xplaymidi or splaymidi.
Fl P#
remap all percussion channels to play on given channel. This
is useful if you have a file with percussion on multiple midi
channels and your midi hardware only supports percussion on
one channel. For example
P10
would send all percussion channels to channel 10.
Fl R#
set initial reverb level. Valid range is 0 - 127.
For fm, the setting is either "on" (nonzero), or "off" (zero).
Fl C#
set initial chorus level. Valid range is 0 - 127.
Fl Vchn,vel[,chn,vel...]
set velocity for all notes in a channel. All velocity information
for the given channel will be replaced by the given velocity. One
day I'll change this option to allow all channels to be modified
as with the
p
option.
Fl x#
excludes the given channel number from the mask of channels to
load from the midi file.
Fl z
zero channel data in output stream -- for special applications.