avplay.texi 4.42 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 -vismv
82
Visualize motion vectors.
83
@item -fast
84
Non-spec-compliant optimizations.
85
@item -genpts
86
Generate pts.
87
@item -rtp_tcp
Diego Biurrun's avatar
Diego Biurrun committed
88 89
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
if you are streaming with the RTSP protocol.
90
@item -sync @var{type}
Diego Biurrun's avatar
Diego Biurrun committed
91
Set the master clock to audio (@code{type=audio}), video
92 93 94 95 96
(@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.
97
@item -threads @var{count}
98
Set the thread count.
99 100 101 102 103 104 105 106 107 108 109 110 111 112 113
@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.
114 115
@item -autoexit
Exit when video is done playing.
116 117 118 119
@item -exitonkeydown
Exit if any key is pressed.
@item -exitonmousedown
Exit if any mouse button is pressed.
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

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

155 156 157 158
@end table

@c man end

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

167 168
@ignore

Anton Khirnov's avatar
Anton Khirnov committed
169 170
@setfilename avplay
@settitle AVplay media player
171 172

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

176
@c man begin AUTHORS
177
The Libav developers
178 179 180 181 182
@c man end

@end ignore

@bye