avplay.texi 4.55 KB
Newer Older
1 2
\input texinfo @c -*- texinfo -*-

Anton Khirnov's avatar
Anton Khirnov committed
3
@settitle avplay Documentation
4
@titlepage
Anton Khirnov's avatar
Anton Khirnov committed
5
@center @titlefont{avplay Documentation}
6 7
@end titlepage

8 9 10 11
@top

@contents

12 13 14 15
@chapter Synopsis

@example
@c man begin SYNOPSIS
Anton Khirnov's avatar
Anton Khirnov committed
16
avplay [options] @file{input_file}
17 18
@c man end
@end example
19

20
@chapter Description
21
@c man begin DESCRIPTION
22

Anton Khirnov's avatar
Anton Khirnov committed
23
AVplay is a very simple and portable media player using the Libav
Diego Biurrun's avatar
Diego Biurrun committed
24
libraries and the SDL library. It is mostly used as a testbed for the
25
various Libav APIs.
26 27
@c man end

28
@chapter Options
29
@c man begin OPTIONS
30

31
@include avtools-common-opts.texi
32

33 34 35
@section Main options

@table @option
36
@item -x @var{width}
37
Force displayed width.
38
@item -y @var{height}
39
Force displayed height.
40
@item -s @var{size}
41
This option has been removed. Use private format options for specifying the
42 43
input video size.  For example with the rawvideo demuxer you need to specify the
option @var{video_size}.
44
@item -an
45
Disable audio.
46
@item -vn
47
Disable video.
48
@item -ss @var{pos}
49
Seek to a given position in seconds.
50 51
@item -t @var{duration}
play <duration> seconds of audio/video
52
@item -bytes
53
Seek by bytes.
54
@item -nodisp
55
Disable graphical display.
56
@item -f @var{fmt}
57
Force format.
58 59
@item -window_title @var{title}
Set window title (default is the input filename).
60 61
@item -loop @var{number}
Loops movie playback <number> times. 0 means forever.
62 63 64 65 66 67
@item -vf @var{filter_graph}
@var{filter_graph} is a description of the filter graph to apply to
the input video.
Use the option "-filters" to show all the available filters (including
also sources and sinks).

68
@end table
69 70 71

@section Advanced options
@table @option
72
@item -pix_fmt @var{format}
73
This option has been removed. Use private options for specifying the
74 75
input pixel format. For example with the rawvideo demuxer you need to specify
the option @var{pixel_format}.
76
@item -stats
Diego Biurrun's avatar
Diego Biurrun committed
77 78
Show the stream duration, the codec parameters, the current position in
the stream and the audio/video synchronisation drift.
79
@item -bug
80
Work around bugs.
81
@item -fast
82
Non-spec-compliant optimizations.
83
@item -genpts
84
Generate pts.
85
@item -rtp_tcp
Diego Biurrun's avatar
Diego Biurrun committed
86 87
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
if you are streaming with the RTSP protocol.
88
@item -sync @var{type}
Diego Biurrun's avatar
Diego Biurrun committed
89
Set the master clock to audio (@code{type=audio}), video
90 91 92 93 94
(@code{type=video}) or external (@code{type=ext}). Default is audio. The
master clock is used to control audio-video synchronization. Most media
players use audio as master clock, but in some cases (streaming or high
quality broadcast) it is necessary to change that. This option is mainly
used for debugging purposes.
95
@item -threads @var{count}
96
Set the thread count.
97 98 99 100 101 102 103 104 105 106 107 108 109 110 111
@item -ast @var{audio_stream_number}
Select the desired audio stream number, counting from 0. The number
refers to the list of all the input audio streams. If it is greater
than the number of audio streams minus one, then the last one is
selected, if it is negative the audio playback is disabled.
@item -vst @var{video_stream_number}
Select the desired video stream number, counting from 0. The number
refers to the list of all the input video streams. If it is greater
than the number of video streams minus one, then the last one is
selected, if it is negative the video playback is disabled.
@item -sst @var{subtitle_stream_number}
Select the desired subtitle stream number, counting from 0. The number
refers to the list of all the input subtitle streams. If it is greater
than the number of subtitle streams minus one, then the last one is
selected, if it is negative the subtitle rendering is disabled.
112 113
@item -noautoexit
Do not exit after playback is finished.
114 115 116 117
@item -exitonkeydown
Exit if any key is pressed.
@item -exitonmousedown
Exit if any mouse button is pressed.
118 119
@item -noautorotate
Disable automatically rotating video based on file metadata.
120 121 122 123 124 125
@end table

@section While playing

@table @key
@item q, ESC
126
Quit.
127 128

@item f
129
Toggle full screen.
130 131

@item p, SPC
132
Pause.
133 134

@item a
135
Cycle audio channel.
136 137

@item v
138
Cycle video channel.
139

140 141 142
@item t
Cycle subtitle channel.

143
@item w
144
Show audio waves.
145 146

@item left/right
147
Seek backward/forward 10 seconds.
148 149

@item down/up
150
Seek backward/forward 1 minute.
151

152 153 154
@item PGDOWN/PGUP
Seek to the previous/next chapter.

155
@item mouse click
156
Seek to percentage in file corresponding to fraction of width.
157

158 159 160 161
@end table

@c man end

Stefano Sabatini's avatar
Stefano Sabatini committed
162
@include eval.texi
John Stebbins's avatar
John Stebbins committed
163
@include decoders.texi
164
@include demuxers.texi
Stefano Sabatini's avatar
Stefano Sabatini committed
165
@include muxers.texi
166 167
@include indevs.texi
@include outdevs.texi
Stefano Sabatini's avatar
Stefano Sabatini committed
168
@include protocols.texi
169 170
@include filters.texi

171 172
@ignore

Anton Khirnov's avatar
Anton Khirnov committed
173 174
@setfilename avplay
@settitle AVplay media player
175 176

@c man begin SEEALSO
177
avconv(1), avprobe(1) and the Libav HTML documentation
178 179
@c man end

180
@c man begin AUTHORS
181
The Libav developers
182 183 184 185 186
@c man end

@end ignore

@bye