Programmable Metronome v. 1.02 
------------------------------
by Grekim Jennings 


Features:
---------

- A click sound with up to 8 octaves of sound with some natural resonance. 

- Fundamental click frequency is adjustable. 

- Audition tempo and the click sound through ALSA. 

- Output to a 16 or 24 bit wave file for import into a DAW. 

- Ability to append your click track file, changing tempo or meter as you go. 

- Read in a tempo map from a text file

- Playback directly through ALSA or write click to a wave file. 

- (new in 1.02) Control parameters in rcmetro.txt file.


Running: 
--------

This a console based application with no GUI. Choose the 32 or 64 bit program 
appropriate to your operating system. Run in the terminal. You will be asked to
choose sample rate and bit depth.  Then a list of commands and options will be 
available. Hit <enter> after a command choice. Note: the click volume is not 
currently adjustable within this program and is reasonably loud on the digital 
scale, so turn down any volume controls/amplifiers until you get a feel for it.
For internal volume adjustment run the alsamixer utility. 


How to Create a Remote Tempo Map File:
--------------------------------------

1. Make a plain text file called tmap.txt. 

2. Start a line with the command tmap for a new tempo or meter. 

3.  Then enter tempo, beats per measure, and measures.  Use a <tab> after tmap 
as well as between values.  For example,

tmap	120	4	48 
tmap	160	3	16 

4. Save the file in same directory as the program. 


Setting parameters in a remote text file  (optional):
-----------------------------------------------------

In a text file in the same directory as the application, you may set parameters 
which will automatically be loaded when you start the metronome program.  The 
file must be named rcmetro.txt.  In this file you start a line with a parameter
name followed by a tab and then the value or name.

Use 'rate' to set the samplerate
'device' for the ALSA output device name 
'bits' to specify 16 or 24 bit format for soundcard and/or output file
'tempo' for tempo in beats per minute 
'Hz' followed by the lowest click frequency 
'atime' for audition time in seconds 
'meter' for beats per measure 
'meas' for number of measures to write to the output file
'save' followed by the name for the click file
'map' for the name of the tempo map to look for.  For example:

rate	44100

bits	16

save	click.wav

