ffplay-doc.texi 3.74 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
@c man begin SYNOPSIS
ffplay [options] @file{input_file}
@c man end
@end example

@c man begin OPTIONS
29 30 31

@include fftools-common-opts.texi

32 33 34
@section Main options

@table @option
35
@item -x @var{width}
36
Force displayed width.
37
@item -y @var{height}
38
Force displayed height.
39
@item -s @var{size}
40
Set frame size (WxH or abbreviation), needed for videos which don't
41
contain a header with the frame size like raw YUV.
42
@item -an
43
Disable audio.
44
@item -vn
45
Disable video.
46
@item -ss @var{pos}
47
Seek to a given position in seconds.
48 49
@item -t @var{duration}
play <duration> seconds of audio/video
50
@item -bytes
51
Seek by bytes.
52
@item -nodisp
53
Disable graphical display.
54
@item -f @var{fmt}
55
Force format.
56 57
@item -window_title @var{title}
Set window title (default is the input filename).
58 59
@item -loop @var{number}
Loops movie playback <number> times. 0 means forever.
60
@end table
61 62 63

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

@section While playing

@table @key
@item q, ESC
112
Quit.
113 114

@item f
115
Toggle full screen.
116 117

@item p, SPC
118
Pause.
119 120

@item a
121
Cycle audio channel.
122 123

@item v
124
Cycle video channel.
125

126 127 128
@item t
Cycle subtitle channel.

129
@item w
130
Show audio waves.
131 132

@item left/right
133
Seek backward/forward 10 seconds.
134 135

@item down/up
136
Seek backward/forward 1 minute.
137 138

@item mouse click
139
Seek to percentage in file corresponding to fraction of width.
140

141 142 143 144 145 146 147 148 149 150
@end table

@c man end

@ignore

@setfilename ffplay
@settitle FFplay media player

@c man begin SEEALSO
151
ffmpeg(1), ffserver(1) and the HTML documentation of @file{ffmpeg}.
152 153 154 155 156 157 158 159 160
@c man end

@c man begin AUTHOR
Fabrice Bellard
@c man end

@end ignore

@bye