Waveplayer 1.05
---------------
by Grekim Jennings


Features:
---------

- Runs from the command terminal.

- Plays 16 and 24 bit mono or stereo wave files.

- Set start and end points for playback.

- Loop audio any number of times.

- Easily adaptable to a script for automated playback of many files, offering
possibilities for composition by being able to play specific sections of  
wavefiles, each with different numbers of repetitions.


Running the Program:
--------------------

If the program is run without command line arguments it will ask you to type 
the name of the wave file and will use the default Alsa soundcard.  Once 
soundcard and wavefile are set, an interactive dialog shows a list commands:

'i' to set in (start) time in seconds
'o' to set out (stop) time in seconds
'p' to play with current settings
'w' to play the whole file
'l' to set the number times to loop (repeat) the selection
'x' to exit
'+' to show additional commands (see below)

In addition, you can use 'px' or 'wx' to exit after playback.



Nudge Commands and Jump Commands:
---------------------------------

'j' to jump the current in/out range ahead (out time becomes in time)
'J' to jump the current in/out range back (in time becomes out time) 

With version 1.15 the following nudge commands are available:

'n' to nudge start forward
'b' to nudge start backward
'no' to nudge stop point forward
'bo' to nudge stop point backward
'N' to nudge both start and stop forward
'B' to nudge both start and stop backward
'nn' to set nudge amount (in samples)



Command Line Arguments:
-----------------------

The arguments are optional, but if you need argument 3, you must enter 
arguments 1 and 2, for example.  A total of 6 arguments are possible.

The first argument is the name of the soundcard device such as plughw:0,0. 
For example, waveplayer plughw:0,0

If you wish to use the default soundcard you may type 'd' or 'default' as the 
first argument.  For example, waveplayer d

The program should run and then ask for the name of the wave file to play.

The second argument is the wavefile name.  For example,

waveplayer plughw:0,0 song1.wav  
or, waveplayer d song1.wav

The 3rd argument is the playback start time in seconds.
The 4th argument is the playback stop time in seconds.

To play from 10.1 seconds to 20.3 seconds in the file type:
waveplayer plughw:0,0 song1.wav 10.1 20.3

The 5th argument will bypass the interactive dialog and the program will insert
this argument directly as the command.  This allows the program to run 
seamlessly from a script. You can enter 'px' to play once (using the in and out
points of arguments 3 and 4) and then exit automatically. Just 'p' will play 
once without exiting. 

Entering 'w' or 'wx' will overwrite arguments 3 and 4 and play the whole file.  
Using 'w' will return you to the interactive dialog, while 'wx' will play one 
time and exit.

For example, to play the entire file and exit:
waveplayer d song1.wav 0 0 wx

The 6th argument can be used to set the number of loops with the
default value being 1 to play just once through.