sap(1) - f14

1sap(1)                                sap                               sap(1)
2
3
4

NAME

6       sap - simple audio player
7
8

SYNOPSIS

10       sap [options] [filename(s)]
11
12

DESCRIPTION

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

USAGE

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

OPTIONS

28       -l, --list
29              play files found in a playlist
30
31       -r, --random
32              play files randomly (requires -l flag first if using playlist)
33
34       -c, --continuous
35              play  files  continuously  (requires  -l  flag  first  if  using
36              playlist)
37
38

CONTROLS

40       The following keypresses will control sap as it is playing
41
42       spacebar: pause
43
44       q: quit
45
46       Down Arrow: volume down
47
48       Up Arrow: volume up
49
50       Left Arrow: seek back
51
52       Right Arrow: seek forward
53
54       b: previous file in cue or playlist
55
56       n: next file in cue or playlist
57
58       For Vi(m) users, the "h, j, k, l" keys behave in a similar  fashion  to
59       the arrow keys.
60

EXAMPLES

62
63
64       Play file1,file2 and file3 in order and quit
65         sap file1 file2 file3
66
67       Play file1,file2 and file3 in order and repeat continuously
68         sap -c file1 file2 file3
69
70       Play file1,file2 and file3 randomly and continuously
71         sap -r file1 file2 file3
72
73       Play all files with .ogg extension in a given directory.
74         sap *.ogg
75
76       Play audio file via http stream
77         sap http://www.example.com/some_audio_file.ogg
78
79       Play files specified in a playlist randomly
80         sap -l -r playlist.txt
81
82

BUGS

84       If  you  encounter any bugs, please report them at https://bugs.launch‐
85       pad.net/sap+
86
87

AUTHOR

94       Jezra Lickter
95
96       Man page written by Jezra Lickter and Jonathan Kulp
97
98
99
100                                 June 29, 2009                          sap(1)