avplay.texi 4.47 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 120 121 122 123
@end table

@section While playing

@table @key
@item q, ESC
124
Quit.
125 126

@item f
127
Toggle full screen.
128 129

@item p, SPC
130
Pause.
131 132

@item a
133
Cycle audio channel.
134 135

@item v
136
Cycle video channel.
137

138 139 140
@item t
Cycle subtitle channel.

141
@item w
142
Show audio waves.
143 144

@item left/right
145
Seek backward/forward 10 seconds.
146 147

@item down/up
148
Seek backward/forward 1 minute.
149

150 151 152
@item PGDOWN/PGUP
Seek to the previous/next chapter.

153
@item mouse click
154
Seek to percentage in file corresponding to fraction of width.
155

156 157 158 159
@end table

@c man end

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

169 170
@ignore

Anton Khirnov's avatar
Anton Khirnov committed
171 172
@setfilename avplay
@settitle AVplay media player
173 174

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

178
@c man begin AUTHORS
179
The Libav developers
180 181 182 183 184
@c man end

@end ignore

@bye