--- name: "wildmidi.cfg" section: "5" platform: "linux" package: "wildmidi" version: "0.5.0-1" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/wildmidi.cfg" --- # wildmidi.cfg(5) Config file for libWildMidi ## NAME wildmidi.cfg - Config file for libWildMidi ## LIBRARY **libWildMidi** ## DESCRIPTION Contains the patch configuration for libWildMidi and location of Gravis Ultrasound compatible patch files. Instead of a patch configuration, the file given to libWildMidi may also be a SoundFont2 (.sf2) file, or a timidity.cfg style file that names one via the **soundfont** directive. The file type is detected by content, not by extension. ``` dir ~/guspats/ source /etc/wildmidi.cfg bank 0 0 acpiano.pat amp=110 env_time4=300 1 brpiano.pat amp=100 drumset 0 25 snarerol keep=env amp=225 note=60 26 snap note=65 ``` ## SYNTAX - **guspat\_editor\_author\_cant\_read\_so\_fix\_release\_time\_for\_me** Some patch file editors switch the 4th and 5th envelopes around making the sound play much longer than intended in players that stuck to the Gravis Ultrasound patch standard. A fix that detects this oversight is applied automatically since WildMidi 0.4.3; this option is accepted for backwards compatibility and has no effect. - **auto\_amp** Forces WildMIDI to amplify samples to their maximum level ignoring the amp=% in the patch lines of the config. - **auto\_amp\_with\_amp** Forces WildMIDI to amplify samples to their maximum level then apply the amp=% in the patch lines of the config. - **dir** *dir-name* Change the search path for config and patch files to *dir-name*. This is specific to the current config file and carried to any included config file unless they have their own **dir** setting. Any included file that has its own **dir** setting does not effect the **dir** setting of the current config file. - **source** *include-confg* Include the settings from *include-config*. Any patch already set will be over-ridden by the included config file. - **soundfont** *sf2-file* Render using the SoundFont2 file *sf2-file* instead of Gravis Ultrasound patches. Relative paths are resolved against the config file directory, the same as **source**. This allows an existing timidity.cfg that names a SoundFont to be used as-is. - **bank** *N* The patches following this setting belong to MIDI instrument bank *N*. - **drumset** *N* The patches following this setting belong to MIDI drum bank *N*. - *patchno* *patchfile* \[**amp=***volume*\] \[**note=***miodinte*\] \[**keep=loop**\] \[**keep=env**\] \[**remove=sustain**\] \[**remove=clamped**\] \[**env\_level**\[*0-5*\]**=***level*\] \[**env\_time**\[*0-5*\]**=***time*\] Example: 0 acpiano.pat amp=110 - *patchno* This is the MIDI patch number the instrument belongs to. - *patchfile* The filename of the Gravis Ultrasound compatible patch file. If the filename is missing the .pat extension, libWildMidi will add .pat when attempting to load the file. - **amp=***volume* Force the volume of the samples in this patch to *volume*% prior to using it. - **note=***midinote* Use note *midinote* when playing the samples in this patch. NOTE: this is for instruments listed under drumset. - **keep=loop** Play the samples in this patch with the loop, when normally we would not for this instrument. - **keep=env** Use the envelope data in this patch, when normally we wouldn't for this instrument. - **remove=sustain** Do note hold the note after the 3rd envelope until note off, which is what happens if the sustain bit is set in the patch file. - **remove=clamped** Do not jump to 6th envelope on note off, which is what happens if the clamped bit is set in the patch file. - **env\_level**\[*0-5*\]**=***level* Set the envelope level to *level* with 1.0 being maximum, and 0.0 being minimum. - Example: set 5th envelope level to 10% - **env\_level\[0-5\]=**0.1 - **env\_time**\[*0-5*\]**=***time* Set the envelope time to *time* with a resolution of 1/1000th of a second. This setting is the time it should take for the envelope to reach maximum level. - Example: set 1st envelope time to 1sec - **env\_time0=**1000 - Example: set 3rd envelope time to 0.5secs - **env\_time2=**500 - **reverb\_room\_width** *fval* Set the room width for the reverb engine in meters. *fval* is a float value in meters. Minimum setting is 1.0 meter, maximum setting is 100.0 meters, and default is 15.0 meters. - Example: set room width to 30 meters - **reverb\_room\_width 30** - **reverb\_room\_length** *fval* Set the room length for the reverb engine in meters. *fval* is a float value in meters. Minimum setting is 1.0 meter, maximum setting is 100.0 meters, and default is 20.0 meters. - Example: set room length to 40 meters - **reverb\_room\_length 40** - **reverb\_listener\_posx** *fval* Set the listener position across the room width for the reverb engine. *fval* is a float value in meters between 0.0 and **reverb\_room\_width**; values outside the room reset to the room centre. Default is half the room width. - **reverb\_listener\_posy** *fval* Set the listener position along the room length for the reverb engine. *fval* is a float value in meters between 0.0 and **reverb\_room\_length**; values outside the room reset to 3/4 of the room length. Default is 3/4 of the room length. ## SEE ALSO [**wildmidi**(1)](/wildmidi/1.md) ## AUTHOR Chris Ison \ Bret Curtis \ ## COPYRIGHT Copyright (C) Chris Ison 2001-2010 Copyright (C) Bret Curtis 2013-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 \. This manpage is licensed under the Creative Commons Attribution-Share 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.