AMBER v 1.2.0 prerelease series

Originally written by Jennifer Bernard <bernarjf@email.uc.edu> and Matthew
McCabe <mccabem@bgnet.bgsu.edu> while they were students at the University
of Richmond.  Jenny has moved on to the University of Cincinatti 
College/Conservatory, and Matt has moved on to Bowling Green State 
University.

Matt currently lives in Sylvania, Ohio and is sporadically working on 
amber when time permits.  Other contributors are more than welcome to 
work on the code, just drop me an email :)



INSTALLATION

Before you install, you should have checked to make sure you have libsndfile
installed.  This is common on Linux machines, but in order for amber to work
on Mac OS X, you have to download and build it.  As of this writing, libsndfile
is not available via fink.

libsndfile home page is:  http://www.zip.com.au/~erikd/libsndfile/

Once you're sure you have libsndfile installed and working, Go to the 
source tree for amber, and type 'make'.

This will generate the amber binary.  


RUNNING AMBER
To run amber, you must have at least one .aiff file that you will be running 
through the program.  Several are included with the program for use with the example files 
given in the example/ directory.  For command line parameters, type ./amber and you will 
get a list of parameters.  For example:

./amber -fn doNot.aiff -fn multi.aiff -o out.aiff -fl 5.0

and so on.


Please see the USAGE file for an explanation of the parameters!
  
You can also run a configuration file containing parameters through the program.  Several
example files are given with the distribution in the examples/ directory. 
  
You can write your own config files by following the format of that file.  Flags for the
name of the parameter must be followed by a tab character, followed by the value of that
parameter.  Do not skip lines between parameters. ./amber -c parameters.txt will run amber
using parameters contained in parameters.txt. 


NOTES 
The original program was developed under Red Hat 6.2, Kernel 2.2.16, using the text editor
vim and the GNU C++ compiler. Currently, most of the development is taking place on Mac OS
X, but we are trying to write it so that it's friendly for many platforms.  It should run
without modification on Linux, Mac OS X 10.2 (Jaguar) and 10.3 (Panther), FreeBSD, any
other OSes using the GNU compilers.  It has also been reported to compile correctly with
Cygwin and Microsoft Visual C++.  If you encounter problems, please drop me an email. 

LICENSE
This program is released under the GNU public license.  Please see
the file LICENSE for details on the terms of use and redistribution.

Please email bugs to one of the above email addresses, or post to our 'Bugs' 
forum on SourceForge.  Some support can also be obtained there, as well as the
latest version.


DEVELOPEMENT
Amber is principally maintained by Matthew McCabe <mccabem@bgnet.bgsu.edu>.  
If you'd like to help out with the development, or have ideas, please 
email me!  

Good luck, and thanks for trying out amber!
