doc/ffplay.texi
e99c4e10
 \input texinfo @c -*- texinfo -*-
 
89b503b5
 @settitle ffplay Documentation
e99c4e10
 @titlepage
89b503b5
 @center @titlefont{ffplay Documentation}
e99c4e10
 @end titlepage
 
a8f0814a
 @top
 
 @contents
 
a66d8cd9
 @chapter Synopsis
 
 @example
 @c man begin SYNOPSIS
9b032c65
 ffplay [options] [@file{input_file}]
a66d8cd9
 @c man end
 @end example
e99c4e10
 
4fff6084
 @chapter Description
e99c4e10
 @c man begin DESCRIPTION
4fff6084
 
a6be21d3
 FFplay is a very simple and portable media player using the FFmpeg
6527639b
 libraries and the SDL library. It is mostly used as a testbed for the
a6be21d3
 various FFmpeg APIs.
e99c4e10
 @c man end
 
a66d8cd9
 @chapter Options
e99c4e10
 @c man begin OPTIONS
8b9da8b5
 
 @include fftools-common-opts.texi
 
e99c4e10
 @section Main options
 
 @table @option
a19caa0f
 @item -x @var{width}
b467be72
 Force displayed width.
a19caa0f
 @item -y @var{height}
b467be72
 Force displayed height.
a19caa0f
 @item -s @var{size}
05e894bc
 Set frame size (WxH or abbreviation), needed for videos which don't
831ec935
 contain a header with the frame size like raw YUV.
e99c4e10
 @item -an
b467be72
 Disable audio.
e99c4e10
 @item -vn
b467be72
 Disable video.
a19caa0f
 @item -ss @var{pos}
b467be72
 Seek to a given position in seconds.
d834d63b
 @item -t @var{duration}
 play <duration> seconds of audio/video
05e894bc
 @item -bytes
b467be72
 Seek by bytes.
e99c4e10
 @item -nodisp
b467be72
 Disable graphical display.
a19caa0f
 @item -f @var{fmt}
b467be72
 Force format.
076db5ed
 @item -window_title @var{title}
 Set window title (default is the input filename).
1922c0a7
 @item -loop @var{number}
 Loops movie playback <number> times. 0 means forever.
f521746b
 @item -showmode @var{mode}
 Set the show mode to use.
 Available values for @var{mode} are:
 @table @samp
 @item 0, video
 show video
 @item 1, waves
 show audio waves
 @item 2, rdft
 show audio frequency band using RDFT ((Inverse) Real Discrete Fourier Transform)
 @end table
 
 Default value is "video", if video is not present or cannot be played
 "rdft" is automatically selected.
 
 You can interactively cycle through the available show modes by
 pressing the key @key{w}.
 
3275ac6a
 @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).
 
9b032c65
 @item -i @var{input_file}
 Read @var{input_file}.
dc7f38f5
 @end table
e99c4e10
 
 @section Advanced options
 @table @option
a19caa0f
 @item -pix_fmt @var{format}
b467be72
 Set pixel format.
e99c4e10
 @item -stats
6527639b
 Show the stream duration, the codec parameters, the current position in
 the stream and the audio/video synchronisation drift.
05e894bc
 @item -bug
b467be72
 Work around bugs.
05e894bc
 @item -fast
b467be72
 Non-spec-compliant optimizations.
05e894bc
 @item -genpts
b467be72
 Generate pts.
e99c4e10
 @item -rtp_tcp
6527639b
 Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
 if you are streaming with the RTSP protocol.
a19caa0f
 @item -sync @var{type}
6527639b
 Set the master clock to audio (@code{type=audio}), video
e99c4e10
 (@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.
a19caa0f
 @item -threads @var{count}
b467be72
 Set the thread count.
4b037567
 @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.
07a90cd5
 @item -autoexit
 Exit when video is done playing.
066ce8c9
 @item -exitonkeydown
 Exit if any key is pressed.
 @item -exitonmousedown
 Exit if any mouse button is pressed.
e99c4e10
 @end table
 
 @section While playing
 
 @table @key
 @item q, ESC
b467be72
 Quit.
e99c4e10
 
 @item f
b467be72
 Toggle full screen.
e99c4e10
 
 @item p, SPC
b467be72
 Pause.
e99c4e10
 
 @item a
b467be72
 Cycle audio channel.
e99c4e10
 
 @item v
b467be72
 Cycle video channel.
e99c4e10
 
173c7185
 @item t
 Cycle subtitle channel.
 
e99c4e10
 @item w
b467be72
 Show audio waves.
05e894bc
 
 @item left/right
b467be72
 Seek backward/forward 10 seconds.
05e894bc
 
 @item down/up
b467be72
 Seek backward/forward 1 minute.
05e894bc
 
 @item mouse click
b467be72
 Seek to percentage in file corresponding to fraction of width.
05e894bc
 
e99c4e10
 @end table
 
 @c man end
 
07851d79
 @include eval.texi
5e45f034
 @include decoders.texi
ef298ea7
 @include demuxers.texi
85466e1e
 @include muxers.texi
4419c8bf
 @include indevs.texi
 @include outdevs.texi
1de4cfe6
 @include protocols.texi
3275ac6a
 @include filters.texi
 
e99c4e10
 @ignore
 
 @setfilename ffplay
 @settitle FFplay media player
 
 @c man begin SEEALSO
a6be21d3
 ffmpeg(1), ffprobe(1), ffserver(1) and the FFmpeg HTML documentation
e99c4e10
 @c man end
 
aeadb328
 @c man begin AUTHORS
a6be21d3
 The FFmpeg developers
e99c4e10
 @c man end
 
 @end ignore
 
 @bye