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