NAME

sf_list - lists the contents of a SoundFont or Gravis file

SYNOPSIS

sf_list Glurk.sf2    # lists bank, patchnum, patchname
sf_list -b 3,4 Groik.sf2    # only shows banks 3 and 4
sf_list -b 0 -p 73 Groik.sf2   # shows bank 0 patch 73
sf_list -b 0 -p 17 -l doc/Jeux14.sf2     # more detail

sf_list Glork.zip    # lists contents of a .zip of GUS
sf_list fiddle.pat       # contents of a GUS .pat file

sf_list -b 0 -c doc/Jeux14.sf2 # suggests timidity.cfg
sf_list -c gravis/Gravis.zip   # suggests timidity.cfg

DESCRIPTION

This script uses the CPAN module MIDI::SoundFont to display a list of the Patches in a .sf2 SoundFont file, or in a Gravis .zip archive, or the contents of a Gravis .pat patch-file.

It is distributed in the ./examples subdirectory of the MIDI::SoundFont module.

It displays the Patches in a readable format, e.g.:

bank 8 patch 17  # Detuned Organ 2

ready for pasting into a midi channel command in muscript, e.g.:

midi channel 3 bank 8 patch 17  # Detuned Organ 2

The muscript file can then be listened to by:

muscript -midi t > t.mid
timidity -x 'soundfont Glurk.sf2' t.mid

OPTIONS

-b 0,127

Only displays the patches in banks 0 and 127. Useful on SoundFont files.

-c

Outputs a suggested timidity.cfg paragraph to allow you to use your soundfont, or gravis patch or zip, in timidity.

You should insert the resulting string into your timidity.cfg by hand, using your favourite text editor, because there are bound to be things you'll want to change.

For Gravis .zip archives, the String::Approx module is used to guess some General-Midi-conformant patch-numbers.

-l

Long output. Useful on SoundFont files, and particularly in conjunction with the -p option.

-p 73,74

Only displays patches number 73 and 74. Useful on SoundFont files, and particularly in conjunction with the -b and -l options.

-v

Prints version number.

CHANGES

20120224  1.0  first working version

AUTHOR

Peter J Billam http://www.pjb.com.au/comp/contact.html

SEE ALSO

MIDI::SoundFont
timidity (1)
http://www.pjb.com.au/
http://www.pjb.com.au/muscript/index.html#midi