wildmidi(1)

NAME
wildmidi - example player for libWildMidi

LIBRARY
libWildMidi

FILES
/etc/wildmidi/wildmidi.cfg

SYNOPSIS
wildmidi [-0abehlnstvO] [-c config-file] [-d audiodev] [-m volume-level] [-P playback-output] [-o file] [-f frequency-Hz(MUS)] [-r sample-rate] [-g convert-xmi-type] [-x file] [-i seconds] [-j seconds] midifile ...

DESCRIPTION
This is a demonstration program to show the capabilities of libWildMidi.

midifile can be a MIDI type file in the HMI, HMP, MIDI, MUS or XMI formats and is processed by libWildMidi and the resulting audio is output by the player.

You can have more than one midifile on the command line and wildmidi will pass them to libWildMidi for processing, one after the other. You can also use wildcards, for example: wildmidi *.mid

OPTIONS

-0  When converting with -x, save files detected as type 2 MIDI compatible as type 0 files.

-a | --textaslyric
    Some files store their lyrics in text meta events. Read lyrics from there instead of lyric meta events.

-b | --reverb
    Turns on an 8 point reverb engine that adds depth to the final mix.

-c config-file | --config config-file
    Uses the configuration file stated by config-file instead of /etc/wildmidi/wildmidi.cfg. config-file may also be a SoundFont2 (.sf2) file, or a timidity.cfg style file using the soundfont directive; the file type is detected by content, not extension.

-d audiodev | --device=audiodev
    Send audio to audiodev instead of the default device.
      alsa : defaults to the system "default"
      oss : defaults to "/dev/dsp"
      netbsd : defaults to "/dev/audio"
      Other environments do not support this option.

-e | --enhanced
    Use enhanced (Gauss) resampling for a richer sound at the cost of extra CPU usage.

-h | --help
    Displays command line options.

-f | --frequency
    Use frequency F Hz for playback (MUS).

-g | --convert
    Convert XMI: 0 - No Conversion (default)
                 1 - MT32 to GM
                 2 - MT32 to GS

-i seconds | --playfrom=seconds
    Begin playback at seconds (fractions allowed) into the file.

-j seconds | --playto=seconds
    Stop playback at seconds (fractions allowed) into the file.

-l | --log_vol
    Some MIDI files have been recorded on hardware that uses a volume curve, making them sound really badly mixed on other MIDI devices. Use this option to use volume curves.

-m volume-level | --mastervol=volume-level
    Set the overall volume level to volume-level. The minimum is 0 and the maximum is 127, with the default being 100.

-P playback-output | --playback=playback-output
    Set playback-output as playback output. See --help output for available playbacks.

-o file | --wavout=file
    Records output to a signed 16 bit stereo format wav file. Implies: -P wave

-O | --opl3
    Use the built-in OPL3 FM synthesizer. No configuration file, GUS patch set or SoundFont is needed.

-r sndrate | --rate=sndrate
    Set the audio output rate to sndrate. The default rate is 32072.

-n | --roundtempo
    Round tempo to nearest whole number.

-s | --skipsilentstart
    Skips any silence at the start of playback.

-v | --version
    Display version and copyright information.

-x file | --tomidi=file
    Convert a MUS, XMI, HMP or HMI file to midi and save it as file.

TEST OPTIONS
These options are not designed for general use. Instead these options are designed to make it easier to listen to specific sound samples.

Note: These options are not displayed by -h | --help

-k N | --test_bank=N
    Set the test bank to N. Range is 0 to 127.

-p N | --test_patch=N
    Set the test patch to N. Range is 0 to 127.

-t | --test_midi
    Plays the built in test midi which plays all 127 notes.

USER INTERFACE
The player accepts limited user input that allows some interaction while playing midi files.

+   Turns the master volume up.

-   Turns the master volume down.

e   Turns enhanced resampling on and off.

l   Turns volume curves on and off.

r   Turns the final mix reverb on and off.

n   Play the next midi on the command line.

m   Save the currently playing file to a midi file. NOTE: This saves to the current directory.

p   Pause the playback. Note: since the audio is buffered it will stop when the audio buffer is empty.

.   Seek forward 1 second. Note: Clears active midi events and will only play midi events from after the new position.

,   Seek backwards 1 second. Note: Clears active midi events and will only play midi events from after the new position.

q   Quit wildmidi.

SEE ALSO
wildmidi.cfg(5)

AUTHOR
Chris Ison <chrisisonwildcode@gmail.com> Bret Curtis <psi29a@gmail.com>

COPYRIGHT
Copyright (C) WildMidi Developers 2001-2026

This file is part of WildMIDI.

WildMIDI is free software: you can redistribute and/or modify the player under the terms of the GNU General Public License and you can redistribute and/or modify the library under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the licenses, or(at your option) any later version.

WildMIDI 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 and the GNU Lesser General Public License for more details.

You should have received a copy of the GNU General Public License and the GNU Lesser General Public License along with WildMIDI. If not, see <http://www.gnu.org/licenses/>.

This manpage is licensed under the Creative Commons AttributionShare Alike 3.0 Unported License. To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/3.0/ or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.