--SAP--

sap is developed in the Vala programming language and needs
the vala compiler (valac) in order to compile the code. Vala
is available online at http://live.gnome.org/Vala

-build instructions-
a build script named "build" is included with the code.
Run the build script from within the source directory.
sap requires ncurses and gstreamer.

-running sap-
from the command line, type "sap " and the name of the
file you wish to play. sap can play audio files over an
http stream. For example:
sap http://www.example.com/some_audio_file.ogg will play
a file over http.

-command line arguments-
-l input file is a list of audio files
-r play list randomly
-c play list continuously

-examples-
sap file1 file2 file3 
this will play file1,file2 and file3 in order and then quit

sap -c file1 file2 file3 
will play file1,file2 and file3 in order and repeat continuously

sap -r file1 file2 file3
will play file1,file2 and file3 randomly and continuously

sap -l playlist.txt
will play files found in a playlist 

sap -r -l playlist.txt
will randomly play files found in a playlist

-controls-
The following keypresses will control sap as it is playing:
Space Bar : pause
q : quit
Down Arrow : volume down
Up Arrow : volume up
Left Arrow : seek back
Right Arrow : seek forward
b: play previous file in list
n: play next file in list

For VI(M) users, the "h,j,k,l" keys behave in a similar fashion
to the Arrow keys.

