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