yading@10: \input texinfo @c -*- texinfo -*-
yading@10: 
yading@10: @settitle ffplay Documentation
yading@10: @titlepage
yading@10: @center @titlefont{ffplay Documentation}
yading@10: @end titlepage
yading@10: 
yading@10: @top
yading@10: 
yading@10: @contents
yading@10: 
yading@10: @chapter Synopsis
yading@10: 
yading@10: ffplay [@var{options}] [@file{input_file}]
yading@10: 
yading@10: @chapter Description
yading@10: @c man begin DESCRIPTION
yading@10: 
yading@10: FFplay is a very simple and portable media player using the FFmpeg
yading@10: libraries and the SDL library. It is mostly used as a testbed for the
yading@10: various FFmpeg APIs.
yading@10: @c man end
yading@10: 
yading@10: @chapter Options
yading@10: @c man begin OPTIONS
yading@10: 
yading@10: @include avtools-common-opts.texi
yading@10: 
yading@10: @section Main options
yading@10: 
yading@10: @table @option
yading@10: @item -x @var{width}
yading@10: Force displayed width.
yading@10: @item -y @var{height}
yading@10: Force displayed height.
yading@10: @item -s @var{size}
yading@10: Set frame size (WxH or abbreviation), needed for videos which do
yading@10: not contain a header with the frame size like raw YUV.  This option
yading@10: has been deprecated in favor of private options, try -video_size.
yading@10: @item -an
yading@10: Disable audio.
yading@10: @item -vn
yading@10: Disable video.
yading@10: @item -ss @var{pos}
yading@10: Seek to a given position in seconds.
yading@10: @item -t @var{duration}
yading@10: play <duration> seconds of audio/video
yading@10: @item -bytes
yading@10: Seek by bytes.
yading@10: @item -nodisp
yading@10: Disable graphical display.
yading@10: @item -f @var{fmt}
yading@10: Force format.
yading@10: @item -window_title @var{title}
yading@10: Set window title (default is the input filename).
yading@10: @item -loop @var{number}
yading@10: Loops movie playback <number> times. 0 means forever.
yading@10: @item -showmode @var{mode}
yading@10: Set the show mode to use.
yading@10: Available values for @var{mode} are:
yading@10: @table @samp
yading@10: @item 0, video
yading@10: show video
yading@10: @item 1, waves
yading@10: show audio waves
yading@10: @item 2, rdft
yading@10: show audio frequency band using RDFT ((Inverse) Real Discrete Fourier Transform)
yading@10: @end table
yading@10: 
yading@10: Default value is "video", if video is not present or cannot be played
yading@10: "rdft" is automatically selected.
yading@10: 
yading@10: You can interactively cycle through the available show modes by
yading@10: pressing the key @key{w}.
yading@10: 
yading@10: @item -vf @var{filtergraph}
yading@10: Create the filtergraph specified by @var{filtergraph} and use it to
yading@10: filter the video stream.
yading@10: 
yading@10: @var{filtergraph} is a description of the filtergraph to apply to
yading@10: the stream, and must have a single video input and a single video
yading@10: output. In the filtergraph, the input is associated to the label
yading@10: @code{in}, and the output to the label @code{out}. See the
yading@10: ffmpeg-filters manual for more information about the filtergraph
yading@10: syntax.
yading@10: 
yading@10: @item -af @var{filtergraph}
yading@10: @var{filtergraph} is a description of the filtergraph to apply to
yading@10: the input audio.
yading@10: Use the option "-filters" to show all the available filters (including
yading@10: sources and sinks).
yading@10: 
yading@10: @item -i @var{input_file}
yading@10: Read @var{input_file}.
yading@10: @end table
yading@10: 
yading@10: @section Advanced options
yading@10: @table @option
yading@10: @item -pix_fmt @var{format}
yading@10: Set pixel format.
yading@10: This option has been deprecated in favor of private options, try -pixel_format.
yading@10: 
yading@10: @item -stats
yading@10: Print several playback statistics, in particular show the stream
yading@10: duration, the codec parameters, the current position in the stream and
yading@10: the audio/video synchronisation drift. It is on by default, to
yading@10: explicitly disable it you need to specify @code{-nostats}.
yading@10: 
yading@10: @item -bug
yading@10: Work around bugs.
yading@10: @item -fast
yading@10: Non-spec-compliant optimizations.
yading@10: @item -genpts
yading@10: Generate pts.
yading@10: @item -rtp_tcp
yading@10: Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
yading@10: if you are streaming with the RTSP protocol.
yading@10: @item -sync @var{type}
yading@10: Set the master clock to audio (@code{type=audio}), video
yading@10: (@code{type=video}) or external (@code{type=ext}). Default is audio. The
yading@10: master clock is used to control audio-video synchronization. Most media
yading@10: players use audio as master clock, but in some cases (streaming or high
yading@10: quality broadcast) it is necessary to change that. This option is mainly
yading@10: used for debugging purposes.
yading@10: @item -threads @var{count}
yading@10: Set the thread count.
yading@10: @item -ast @var{audio_stream_number}
yading@10: Select the desired audio stream number, counting from 0. The number
yading@10: refers to the list of all the input audio streams. If it is greater
yading@10: than the number of audio streams minus one, then the last one is
yading@10: selected, if it is negative the audio playback is disabled.
yading@10: @item -vst @var{video_stream_number}
yading@10: Select the desired video stream number, counting from 0. The number
yading@10: refers to the list of all the input video streams. If it is greater
yading@10: than the number of video streams minus one, then the last one is
yading@10: selected, if it is negative the video playback is disabled.
yading@10: @item -sst @var{subtitle_stream_number}
yading@10: Select the desired subtitle stream number, counting from 0. The number
yading@10: refers to the list of all the input subtitle streams. If it is greater
yading@10: than the number of subtitle streams minus one, then the last one is
yading@10: selected, if it is negative the subtitle rendering is disabled.
yading@10: @item -autoexit
yading@10: Exit when video is done playing.
yading@10: @item -exitonkeydown
yading@10: Exit if any key is pressed.
yading@10: @item -exitonmousedown
yading@10: Exit if any mouse button is pressed.
yading@10: 
yading@10: @item -codec:@var{media_specifier} @var{codec_name}
yading@10: Force a specific decoder implementation for the stream identified by
yading@10: @var{media_specifier}, which can assume the values @code{a} (audio),
yading@10: @code{v} (video), and @code{s} subtitle.
yading@10: 
yading@10: @item -acodec @var{codec_name}
yading@10: Force a specific audio decoder.
yading@10: 
yading@10: @item -vcodec @var{codec_name}
yading@10: Force a specific video decoder.
yading@10: 
yading@10: @item -scodec @var{codec_name}
yading@10: Force a specific subtitle decoder.
yading@10: @end table
yading@10: 
yading@10: @section While playing
yading@10: 
yading@10: @table @key
yading@10: @item q, ESC
yading@10: Quit.
yading@10: 
yading@10: @item f
yading@10: Toggle full screen.
yading@10: 
yading@10: @item p, SPC
yading@10: Pause.
yading@10: 
yading@10: @item a
yading@10: Cycle audio channel.
yading@10: 
yading@10: @item v
yading@10: Cycle video channel.
yading@10: 
yading@10: @item t
yading@10: Cycle subtitle channel.
yading@10: 
yading@10: @item w
yading@10: Show audio waves.
yading@10: 
yading@10: @item left/right
yading@10: Seek backward/forward 10 seconds.
yading@10: 
yading@10: @item down/up
yading@10: Seek backward/forward 1 minute.
yading@10: 
yading@10: @item page down/page up
yading@10: Seek backward/forward 10 minutes.
yading@10: 
yading@10: @item mouse click
yading@10: Seek to percentage in file corresponding to fraction of width.
yading@10: 
yading@10: @end table
yading@10: 
yading@10: @c man end
yading@10: 
yading@10: @ifset config-all
yading@10: @include all-components.texi
yading@10: @end ifset
yading@10: 
yading@10: @chapter See Also
yading@10: 
yading@10: @ifhtml
yading@10: @ifset config-all
yading@10: @url{ffplay.html,ffplay},
yading@10: @end ifset
yading@10: @ifset config-not-all
yading@10: @url{ffplay-all.html,ffmpeg-all},
yading@10: @end ifset
yading@10: @url{ffmpeg.html,ffmpeg}, @url{ffprobe.html,ffprobe}, @url{ffserver.html,ffserver},
yading@10: @url{ffmpeg-utils.html,ffmpeg-utils},
yading@10: @url{ffmpeg-scaler.html,ffmpeg-scaler},
yading@10: @url{ffmpeg-resampler.html,ffmpeg-resampler},
yading@10: @url{ffmpeg-codecs.html,ffmpeg-codecs},
yading@10: @url{ffmpeg-bitstream-filters.html,ffmpeg-bitstream-filters},
yading@10: @url{ffmpeg-formats.html,ffmpeg-formats},
yading@10: @url{ffmpeg-devices.html,ffmpeg-devices},
yading@10: @url{ffmpeg-protocols.html,ffmpeg-protocols},
yading@10: @url{ffmpeg-filters.html,ffmpeg-filters}
yading@10: @end ifhtml
yading@10: 
yading@10: @ifnothtml
yading@10: @ifset config-all
yading@10: ffplay(1),
yading@10: @end ifset
yading@10: @ifset config-not-all
yading@10: ffplay-all(1),
yading@10: @end ifset
yading@10: ffmpeg(1), ffprobe(1), ffserver(1),
yading@10: ffmpeg-utils(1), ffmpeg-scaler(1), ffmpeg-resampler(1),
yading@10: ffmpeg-codecs(1), ffmpeg-bitstream-filters(1), ffmpeg-formats(1),
yading@10: ffmpeg-devices(1), ffmpeg-protocols(1), ffmpeg-filters(1)
yading@10: @end ifnothtml
yading@10: 
yading@10: @include authors.texi
yading@10: 
yading@10: @ignore
yading@10: 
yading@10: @setfilename ffplay
yading@10: @settitle FFplay media player
yading@10: 
yading@10: @end ignore
yading@10: 
yading@10: @bye