Release 1.19.2
[platform/upstream/gstreamer.git] / tools / gst-play-1.0.1
1 .TH "GStreamer" "1" "April 2014" "" ""
2 .SH "NAME"
3 gst\-play\-1.0 \- Simple command line playback testing tool
4 .SH "SYNOPSIS"
5 \fBgst\-play\-1.0\fR \fIFILE|DIRECTORY|URI [FILE2|DIRECTORY2|URI2]\fR
6 .SH "DESCRIPTION"
7 .LP
8 \fIgst\-play\-1.0\fP is a command line tool that can be used to test
9 basic playback using the playbin element. You can pass it individual files,
10 URIs or whole directories (in which case it will recurse into sub-directories
11 as well).
12
13 .SH "OPTIONS"
14 .l
15 \fIgst\-play\-1.0\fP accepts the following options:
16 .TP 8
17 .B  \-\-help
18 Print help synopsis and available command line options
19 .TP 8
20 .B  \-\-version
21 Print version and exit
22 .TP 8
23 .B  \-\-audiosink=SOMESINK
24 Use the SOMESINK element as audio sink instead of autoaudiosink
25 .TP 8
26 .B  \-\-videosink=SOMESINK
27 Use the SOMESINK element as video sink instead of autovideosink
28 .TP 8
29 .B  \-\-volume=VOLUME
30 Set initial playback volume to VOLUME, where 0.0=silent and 1.0=unchanged
31 .TP 8
32 .B  \-\-shuffle
33 Shuffle playlist (play files in random order)
34 .TP 8
35 .B  \-\-no-interactive
36 Disable control through keyboard interaction in terminal (see below)
37 .TP 8
38 .B  \-\-gapless
39 Enable gapless playback
40 .TP 8
41 .B  \-v, \-\-flags
42 Control playback behaviour setting playbin 'flags' property
43 .TP 8
44 .B  \-v, \-\-verbose
45 Output status information and property notifications
46 .TP 8
47 .B  \-q, \-\-quiet
48 Do not print any output (apart from errors)
49 .TP 8
50 .B  \-\-use\-playbin3
51 Use playbin3 pipeline (default varies depending on 'USE_PLAYBIN' env variable)
52 .TP 8
53 .B  \-\-wait\-on\-eos
54 Keep showing the last frame on EOS until quit or playlist change command (gapless is ignored)
55
56 .SH "INTERACTIVE KEYBOARD CONTROL"
57 .l
58 .TP 8
59 .B  SPACE
60 Pause/Resume playback
61 .TP 8
62 .B  ARROW UP/DOWN
63 Volume up/down
64 .TP 8
65 .B  ARROW LEFT/RIGHT
66 Seek back/forward
67 .TP 8
68 .B  +/-
69 Increase/decrease playback rate
70 .TP 8
71 .B  d
72 Reverse playback direction
73 .TP 8
74 .B  t
75 Cycle through trick modes
76 .TP 8
77 .B  a
78 Switch audio track
79 .TP 8
80 .B  s
81 Switch subtitle track
82 .TP 8
83 .B  v
84 Switch video track
85 .TP 8
86 .B  > or n
87 Skip to next item in playlist
88 .TP 8
89 .B  < or b
90 Go back to previous item in playlist
91 .TP 8
92 .B  0
93 Seek back to beginning of current track
94 .TP 8
95 .B  Q, ESC
96 Quit
97
98 .SH "SEE ALSO"
99 .BR gst\-inspect\-1.0 (1),
100 .BR gst\-launch\-1.0 (1),
101 .BR gst\-discoverer\-1.0 (1),
102 .SH "AUTHOR"
103 The GStreamer team at http://gstreamer.freedesktop.org/