ffplay-doc.texi 3.52 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14
\input texinfo @c -*- texinfo -*-

@settitle FFplay Documentation
@titlepage
@sp 7
@center @titlefont{FFplay Documentation}
@sp 3
@end titlepage


@chapter Introduction

@c man begin DESCRIPTION
FFplay is a very simple and portable media player using the FFmpeg
Diego Biurrun's avatar
Diego Biurrun committed
15 16
libraries and the SDL library. It is mostly used as a testbed for the
various FFmpeg APIs.
17 18 19 20 21
@c man end

@chapter Invocation

@section Syntax
22
@example
23 24 25 26 27 28 29 30 31
@c man begin SYNOPSIS
ffplay [options] @file{input_file}
@c man end
@end example

@c man begin OPTIONS
@section Main options

@table @option
32
@include fftools-common-opts.texi
33
@item -x @var{width}
34
Force displayed width.
35
@item -y @var{height}
36
Force displayed height.
37
@item -s @var{size}
38
Set frame size (WxH or abbreviation), needed for videos which don't
39
contain a header with the frame size like raw YUV.
40
@item -an
41
Disable audio.
42
@item -vn
43
Disable video.
44
@item -ss @var{pos}
45
Seek to a given position in seconds.
46
@item -bytes
47
Seek by bytes.
48
@item -nodisp
49
Disable graphical display.
50
@item -f @var{fmt}
51
Force format.
52
@end table
53 54 55

@section Advanced options
@table @option
56
@item -pix_fmt @var{format}
57
Set pixel format.
58
@item -stats
Diego Biurrun's avatar
Diego Biurrun committed
59 60
Show the stream duration, the codec parameters, the current position in
the stream and the audio/video synchronisation drift.
61
@item -debug
62
Print specific debug info.
63
@item -bug
64
Work around bugs.
65
@item -vismv
66
Visualize motion vectors.
67
@item -fast
68
Non-spec-compliant optimizations.
69
@item -genpts
70
Generate pts.
71
@item -rtp_tcp
Diego Biurrun's avatar
Diego Biurrun committed
72 73
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
if you are streaming with the RTSP protocol.
74
@item -sync @var{type}
Diego Biurrun's avatar
Diego Biurrun committed
75
Set the master clock to audio (@code{type=audio}), video
76 77 78 79 80
(@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.
81
@item -threads @var{count}
82
Set the thread count.
83 84 85 86 87 88 89 90 91 92 93 94 95 96 97
@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.
98 99 100 101 102 103
@end table

@section While playing

@table @key
@item q, ESC
104
Quit.
105 106

@item f
107
Toggle full screen.
108 109

@item p, SPC
110
Pause.
111 112

@item a
113
Cycle audio channel.
114 115

@item v
116
Cycle video channel.
117

118 119 120
@item t
Cycle subtitle channel.

121
@item w
122
Show audio waves.
123 124

@item left/right
125
Seek backward/forward 10 seconds.
126 127

@item down/up
128
Seek backward/forward 1 minute.
129 130

@item mouse click
131
Seek to percentage in file corresponding to fraction of width.
132

133 134 135 136 137 138 139 140 141 142
@end table

@c man end

@ignore

@setfilename ffplay
@settitle FFplay media player

@c man begin SEEALSO
143
ffmpeg(1), ffserver(1) and the HTML documentation of @file{ffmpeg}.
144 145 146 147 148 149 150 151 152
@c man end

@c man begin AUTHOR
Fabrice Bellard
@c man end

@end ignore

@bye