1wildmidi(1)                     WildMidi Player                    wildmidi(1)
2
3
4

NAME

6       wildmidi - example player for libWildMidi
7

LIBRARY

9       libWildMidi
10

FILES

12       /etc/wildmidi/wildmidi.cfg
13

SYNOPSIS

15       wildmidi  [-bhlvwnst]  [-c config-file] [-d audiodev] [-m volume-level]
16       [-o wav-file] [-f frequency-Hz(MUS)] [-r sample-rate] [-g  convert-xmi-
17       type] midifile ...
18

DESCRIPTION

20       This  is  a  demonstration program to show the capabilities of libWild‐
21       Midi.
22
23       midifile can be a MIDI type file in the HMI, HMP, MIDI, MUS or XMI for‐
24       mats  and is processed by libWildMidi and the resulting audio is output
25       by the player.
26
27       You can have more than one midifile on the command  line  and  wildmidi
28       will  pass them to libWildMidi for processing, one after the other. You
29       can also use wildcards, for example: wildmidi *.mid
30

OPTIONS

32       -b | --reverb
33              Turns on an 8 point reverb engine that adds depth to  the  final
34              mix.
35
36       -c config-file | --config config-file
37              Uses  the  configuration  file  stated by config-file instead of
38              /etc/wildmidi/wildmidi.cfg
39
40       -d audiodev | --device=audiodev
41              Send the audio to audiodev instead of the default. ALSA defaults
42              to  the system "default" while OSS defaults to "/dev/dsp". Other
43              environments do not support this option.
44
45       -h | --help
46              Displays command line options.
47
48       -f | --frequency
49              Use frequency F Hz for playback (MUS).
50
51       -g | --convert
52              Convert XMI: 0 - No Conversion (default)
53                           1 - MT32 to GM
54                           2 - MT32 to GS
55
56       -l | --log_vol
57              Some MIDI files have been recorded on hardware that uses a  vol‐
58              ume  curve,  making  them sound really badly mixed on other MIDI
59              devices. Use this option to use volume curves.
60
61       -m volume-level | --mastervol=volume-level
62              Set the overall volume level to volume-level. The minimum  is  0
63              and the maximum is 127, with the default being 100.
64
65       -o wav-file | --wavout=wav-file
66              Records the audio in wav format to wav-file.
67
68       -r sndrate | --rate=sndrate
69              Set the audio output rate to sndrate. The default rate is 32072.
70
71       -n | --roundtempo
72              Round tempo to nearest whole number.
73
74       -s | --skipsilentstart
75              Skips any silence at the start of playback.
76
77       -v | --version
78              Display version and copyright information.
79
80       -x | --tomidi
81              Convert a MUS or an XMI file to midi and save to file.
82

TEST OPTIONS

84       These  options  are not designed for general use. Instead these options
85       are designed to make it easier to listen to specific sound samples.
86
87       Note: These options are not displayed by -h | --help
88
89       -k N | --test_bank=N
90              Set the test bank to N. Range is 0 to 127.
91
92       -p N | --test_patch=N
93              Set the test patch to N. Range is 0 to 127.
94
95       -t | --test_midi
96              Plays the built in test midi which plays all 127 notes.
97

USER INTERFACE

99       The player accepts limited user  input  that  allows  some  interaction
100       while playing midi files.
101
102       +      Turns the master volume up.
103
104       -      Turns the master volume down.
105
106       e      Turns enhanced resampling on and off.
107
108       l      Turns volume curves on and off.
109
110       r      Turns the final mix reverb on and off.
111
112       n      Play the next midi on the command line.
113
114       m      Save the currently playing file to a midi file. NOTE: This saves
115              to the current directory.
116
117       p      Pause the playback. Note: since the audio is  buffered  it  will
118              stop when the audio buffer is empty.
119
120       .      Seek  forward 1 second. Note: Clears active midi events and will
121              only play midi events from after the new position.
122
123       ,      Seek backwards 1 second. Note: Clears  active  midi  events  and
124              will only play midi events from after the new position.
125
126       q      Quit wildmidi.
127

SEE ALSO

129       wildmidi.cfg(5)
130

AUTHOR

132       Chris Ison <chrisisonwildcode@gmail.com> Bret Curtis <psi29a@gmail.com>
133
135       Copyright (C) WildMidi Developers 2001-2016
136
137       This file is part of WildMIDI.
138
139       WildMIDI  is  free  software:  you  can  redistribute and/or modify the
140       player under the terms of the GNU General Public License  and  you  can
141       redistribute  and/or  modify  the  library  under  the terms of the GNU
142       Lesser General Public License as published by the Free Software Founda‐
143       tion,  either  version  3 of the licenses, or(at your option) any later
144       version.
145
146       WildMIDI is distributed in the hope that it will be useful, but WITHOUT
147       ANY  WARRANTY;  without even the implied warranty of MERCHANTABILITY or
148       FITNESS FOR A PARTICULAR PURPOSE. See the GNU  General  Public  License
149       and the GNU Lesser General Public License for more details.
150
151       You  should  have received a copy of the GNU General Public License and
152       the GNU Lesser General Public License along with WildMIDI. If not,  see
153       <http://www.gnu.org/licenses/>.
154
155       This  manpage  is  licensed under the Creative Commons AttributionShare
156       Alike 3.0 Unported License. To view  a  copy  of  this  license,  visit
157       http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Cre‐
158       ative Commons, 171 Second Street, Suite 300, San Francisco, California,
159       94105, USA.
160
161                                 10 March 2016                     wildmidi(1)
Impressum