earwhip: audio flashcard system for pitch recognition training.

Authors: Ben Collins-Sussman <sussman@red-bean.com>
         Karl Fogel <kfogel@red-bean.com>

This program picks a random pitch, with a certain duration and
instrument, generates MIDI output for it, and plays the MIDI data.
(It either pipes the data through a software synthesizer to generate
WAV data, which is then played through yer basic sound card, or it can
run a midi playing program).  Shortly after the pitch is played, it
pops up a GTK window on multiple displays, like a flashcard, saying
what the pitch and instrument were.

Should work under Linux and FreeBSD.

Requirements:

   1. Install the Perl MIDI::Simple module and friends, available from
      CPAN.  The version we got was `MIDI-Perl-0.77.tar.gz'.

   2. Run "make install".  This will build the gpopup binary, and
      install it along with the Perl scripts, to /usr/local/bin, which
      should be in your PATH.

   3. IF you'll be doing software synthesis:
        We recommend Timidity, a software synth.  Grab it from
        http://www.goice.co.jp/member/mo/timidity/, compile it, and
        install it somewhere in your PATH.  Earwhip assumes timidity
        by default, so it will be used automatically.
      ELSE:
        Make sure you have some midi player in your path, and pass its
        name to earwhip.pl using the -m option.

   4. Have a sound card that works. :-)

Run "earwhip.pl --help" to see its usage.

Ignore the samples/ directory, it's only for testing timidity.