README.md
BeatMatch v2.0
==============

BeatMatch is a utility that lets you precisely measure a tempo in beats per minute. And now you can also use it as a dynamic metronome!

Tap out a beat on either the Beat button, or the Up button, and at the top of the screen you'll see the beats-per-minute (BPM) of your beat, the number of beats since your first tap, and the elapsed time between your first tap and your last.

When the "Metronome Mode" box is checked, you only need to tap out a few careful beats at the beginning, and then you can hear if the palm's beat drifts away from the beat you're measuring. When this happens, just tap along with the beat you're measuring a few more times to brinq it back on track.

Start over by tapping the Reset button (the one on the screen!), or the Down button.

One word of caution: While acting as a Metronome, the device won't automatically turn off. You can still turn it off by hand (press the power button), or hit reset to stop the beat.


(c) 2001 Ben Levitt
benjie@stanfordalumni.org



Installation:
============
Install "BeatMatch.prc" just as you would any other Palm application, using the "Install" option of your Palm Desktop software.



Files in this distribution:
===========================

- BeatMatch.prc - This is the app. It's all you need to insall.

- readme.txt - self reference

- Licence.txt - GNU public licence

- src.zip (Source code for BeatMatch, meant for use with OnBoardC)
- OnBoardHeader.h.pdb - modified OnBoardC header file
- BeatMatch.c.pdb - c code of BeatMatch in DOC format.
- BeatMatch.rsrc.prc - resource file.



Version History
===============

v2.0
- Added the Metronome functionality.
- Slightly improved the accuracy of the beat counting.
- Increased ergonomics! :] Now (while in metronome mode) you can tap a few beats, stop, and tap a few more as needed to keep it on the beat. (You don't have to tap every single beat.)
- Added preferences. BeatMatch remembers the last beat you tapped out.

v1.1
- Added hard-button support using the up and down buttons. These seems slightly more responsive than the on-screen button.
- Also, added 2 decimal places of precision (and accuracy as far as I can tell).

v1.01
- Fixed a nasty timing bug. The bpm measure was off by 40% (yowza!). Now it's right on.

v1.0
- Tap a beat and see the bpm on the screen.




For more info, feature requests or bug reports, please email me at benjie@stanfordalumni.org.



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 2 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, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.