= SFZer

* http://sfzer.rubyforge.org
* http://rubyforge.org/projects/sfzer/
* http://christessmer.com


== DESCRIPTION:

SFZer recursively scans through directories of Multisamples (.wav, .aiff, .ogg,
etc) and automagically generates SFZ soundfonts from what it finds.


=== Related Projects:
* The *SFZ* format: http://www.cakewalk.com/DevXchange/sfz.asp
* The *makesfz.pl* perl scripts , by Peter L. Jones: http://www.drealm.info/sfz/


== FEATURES/PROBLEMS:

* Quickly converts entire directories of named samples into SFZ instruments.
* Creates quick keyboard mapping from sample file names.
* Automatically computes xfades between adjacent samples over a semitone apart.

=== Future Plans:
* Numeric Notes (some filenames use the numeric instead of chromatic key value)
* Future Music sample name format (sample order number + chromatic value)
* Specify multisamples to include or exclude by name or pattern.
* Specify minimum number of regions/samples in a multisample.
* loop_mode=one-shot option for percussion

=== Ideas without much substance yet:
* Option to force SFZv1 and SFZv2 output (nothing requires this yet)
* Default effect/ CC controller options
* (possibly) 2-n pass (as opposed to 1-pass) processing?


== SYNOPSIS:

% sfzer [options] directorie(s)


== REQUIREMENTS:

* Ruby


== INSTALL:

% sudo gem install sfzer


== LICENSE:

(The GPL License, version 3)

Copyright (c) 2008, 2009 Chris Tessmer

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

This program 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 for more details.

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