Make a copy of ffmpeg under a new name -- avconv.
[libav.git] / doc / avplay.texi
CommitLineData
e99c4e10
FB
1\input texinfo @c -*- texinfo -*-
2
266463da 3@settitle avplay Documentation
e99c4e10 4@titlepage
266463da 5@center @titlefont{avplay Documentation}
e99c4e10
FB
6@end titlepage
7
a8f0814a
JG
8@top
9
10@contents
11
a66d8cd9
SS
12@chapter Synopsis
13
14@example
15@c man begin SYNOPSIS
266463da 16avplay [options] @file{input_file}
a66d8cd9
SS
17@c man end
18@end example
e99c4e10 19
4fff6084 20@chapter Description
e99c4e10 21@c man begin DESCRIPTION
4fff6084 22
266463da 23AVplay is a very simple and portable media player using the Libav
6527639b 24libraries and the SDL library. It is mostly used as a testbed for the
f8a45fa1 25various Libav APIs.
e99c4e10
FB
26@c man end
27
a66d8cd9 28@chapter Options
e99c4e10 29@c man begin OPTIONS
8b9da8b5
SS
30
31@include fftools-common-opts.texi
32
e99c4e10
FB
33@section Main options
34
35@table @option
a19caa0f 36@item -x @var{width}
b467be72 37Force displayed width.
a19caa0f 38@item -y @var{height}
b467be72 39Force displayed height.
a19caa0f 40@item -s @var{size}
a4e540c4
SS
41This option has been removed. Use private format options for specifying the
42input video size.
e99c4e10 43@item -an
b467be72 44Disable audio.
e99c4e10 45@item -vn
b467be72 46Disable video.
a19caa0f 47@item -ss @var{pos}
b467be72 48Seek to a given position in seconds.
d834d63b
RK
49@item -t @var{duration}
50play <duration> seconds of audio/video
05e894bc 51@item -bytes
b467be72 52Seek by bytes.
e99c4e10 53@item -nodisp
b467be72 54Disable graphical display.
a19caa0f 55@item -f @var{fmt}
b467be72 56Force format.
076db5ed
RK
57@item -window_title @var{title}
58Set window title (default is the input filename).
1922c0a7
RK
59@item -loop @var{number}
60Loops movie playback <number> times. 0 means forever.
3275ac6a
SS
61@item -vf @var{filter_graph}
62@var{filter_graph} is a description of the filter graph to apply to
63the input video.
64Use the option "-filters" to show all the available filters (including
65also sources and sinks).
66
dc7f38f5 67@end table
e99c4e10
FB
68
69@section Advanced options
70@table @option
a19caa0f 71@item -pix_fmt @var{format}
0a858048
SS
72This option has been removed. Use private options for specifying the
73input pixel format.
e99c4e10 74@item -stats
6527639b
DB
75Show the stream duration, the codec parameters, the current position in
76the stream and the audio/video synchronisation drift.
05e894bc 77@item -debug
b467be72 78Print specific debug info.
05e894bc 79@item -bug
b467be72 80Work around bugs.
05e894bc 81@item -vismv
b467be72 82Visualize motion vectors.
05e894bc 83@item -fast
b467be72 84Non-spec-compliant optimizations.
05e894bc 85@item -genpts
b467be72 86Generate pts.
e99c4e10 87@item -rtp_tcp
6527639b
DB
88Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
89if you are streaming with the RTSP protocol.
a19caa0f 90@item -sync @var{type}
6527639b 91Set the master clock to audio (@code{type=audio}), video
e99c4e10
FB
92(@code{type=video}) or external (@code{type=ext}). Default is audio. The
93master clock is used to control audio-video synchronization. Most media
94players use audio as master clock, but in some cases (streaming or high
95quality broadcast) it is necessary to change that. This option is mainly
96used for debugging purposes.
a19caa0f 97@item -threads @var{count}
b467be72 98Set the thread count.
4b037567
SS
99@item -ast @var{audio_stream_number}
100Select the desired audio stream number, counting from 0. The number
101refers to the list of all the input audio streams. If it is greater
102than the number of audio streams minus one, then the last one is
103selected, if it is negative the audio playback is disabled.
104@item -vst @var{video_stream_number}
105Select the desired video stream number, counting from 0. The number
106refers to the list of all the input video streams. If it is greater
107than the number of video streams minus one, then the last one is
108selected, if it is negative the video playback is disabled.
109@item -sst @var{subtitle_stream_number}
110Select the desired subtitle stream number, counting from 0. The number
111refers to the list of all the input subtitle streams. If it is greater
112than the number of subtitle streams minus one, then the last one is
113selected, if it is negative the subtitle rendering is disabled.
07a90cd5
AS
114@item -autoexit
115Exit when video is done playing.
066ce8c9
AS
116@item -exitonkeydown
117Exit if any key is pressed.
118@item -exitonmousedown
119Exit if any mouse button is pressed.
e99c4e10
FB
120@end table
121
122@section While playing
123
124@table @key
125@item q, ESC
b467be72 126Quit.
e99c4e10
FB
127
128@item f
b467be72 129Toggle full screen.
e99c4e10
FB
130
131@item p, SPC
b467be72 132Pause.
e99c4e10
FB
133
134@item a
b467be72 135Cycle audio channel.
e99c4e10
FB
136
137@item v
b467be72 138Cycle video channel.
e99c4e10 139
173c7185
BA
140@item t
141Cycle subtitle channel.
142
e99c4e10 143@item w
b467be72 144Show audio waves.
05e894bc
LW
145
146@item left/right
b467be72 147Seek backward/forward 10 seconds.
05e894bc
LW
148
149@item down/up
b467be72 150Seek backward/forward 1 minute.
05e894bc
LW
151
152@item mouse click
b467be72 153Seek to percentage in file corresponding to fraction of width.
05e894bc 154
e99c4e10
FB
155@end table
156
157@c man end
158
07851d79 159@include eval.texi
ef298ea7 160@include demuxers.texi
85466e1e 161@include muxers.texi
4419c8bf
SS
162@include indevs.texi
163@include outdevs.texi
1de4cfe6 164@include protocols.texi
3275ac6a
SS
165@include filters.texi
166
e99c4e10
FB
167@ignore
168
266463da
AK
169@setfilename avplay
170@settitle AVplay media player
e99c4e10
FB
171
172@c man begin SEEALSO
6291d7e4 173avconv(1), avprobe(1), avserver(1) and the Libav HTML documentation
e99c4e10
FB
174@c man end
175
aeadb328 176@c man begin AUTHORS
f8a45fa1 177The Libav developers
e99c4e10
FB
178@c man end
179
180@end ignore
181
182@bye