sap man page

sap — simple audio player

Synopsis

sap [options] [filename(s)]

Description

sap is a utility for playing audio files in various formats, including .ogg and .flac. It can also play audio files over an http stream. sap uses GStreamer media plugins and should be able to play any audio file handled by a gstreamer plugin; such as .mp3 and .midi.

Usage

From the command line, type "sap" and the name of the file(s), playlist, or stream you wish to play. Playlists should be in plain-text format and should have complete paths to audio files. You may also use wildcards to play multiple files in a directory.

Options

-l, --list
play files found in a playlist
-r, --random
play files randomly (requires -l flag first if using playlist)
-c, --continuous
play files continuously (requires -l flag first if using playlist)

Controls

The following keypresses will control sap as it is playing

spacebar: pause

q: quit

Down Arrow: volume down

Up Arrow: volume up

Left Arrow: seek back

Right Arrow: seek forward

b: previous file in cue or playlist

n: next file in cue or playlist

For Vi(m) users, the "h, j, k, l" keys behave in a similar fashion to the arrow keys.

Examples

Play file1,file2 and file3 in order and quit
sap file1 file2 file3
Play file1,file2 and file3 in order and repeat continuously
sap -c file1 file2 file3
Play file1,file2 and file3 randomly and continuously
sap -r file1 file2 file3
Play all files with .ogg extension in a given directory.
sap *.ogg
Play audio file via http stream
sap http://www.example.com/some_audio_file.ogg
Play files specified in a playlist randomly
sap -l -r playlist.txt

Bugs

If you encounter any bugs, please report them at https://bugs.launchpad.net/sap+

See Also

https://launchpad.net/sap+
http://www.jezra.net/projects/sap

Author

Jezra Lickter

Man page written by Jezra Lickter and Jonathan Kulp

Info

June 29, 2009 sap