Synopsis
********

ffplay [OPTIONS] [input_file]

Description
***********

FFplay is a very simple and portable media player using the FFmpeg libraries and the SDL library. It is mostly used as a testbed for the various FFmpeg APIs.

Options
*******

     [file fftools-common-opts.texi not included]

Main options
============

-x WIDTH
     Force displayed width.

-y HEIGHT
     Force displayed height.

-s SIZE
     Set frame size (WxH or abbreviation), needed for videos which do not contain a header with the frame size like raw YUV.  This option has been deprecated in favor of private options, try -video_size.

-fs
     Start in fullscreen mode.

-an
     Disable audio.

-vn
     Disable video.

-sn
     Disable subtitles.

-ss POS
     Seek to a given position in seconds.

-t DURATION
     play <duration> seconds of audio/video

-bytes
     Seek by bytes.

-nodisp
     Disable graphical display.

-f FMT
     Force format.

-window_title TITLE
     Set window title (default is the input filename).

-loop NUMBER
     Loops movie playback <number> times. 0 means forever.

-showmode MODE
     Set the show mode to use. Available values for MODE are:

     0, video
          show video

     1, waves
          show audio waves

     2, rdft
          show audio frequency band using RDFT ((Inverse) Real Discrete Fourier Transform)

     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 w.

-vf FILTERGRAPH
     Create the filtergraph specified by FILTERGRAPH and use it to filter the video stream.

     FILTERGRAPH is a description of the filtergraph to apply to the stream, and must have a single video input and a single video output. In the filtergraph, the input is associated to the label in, and the output to the label out. See the ffmpeg-filters manual for more information about the filtergraph syntax.

     You can specify this parameter multiple times and cycle through the specified filtergraphs along with the show modes by pressing the key w.

-af FILTERGRAPH
     FILTERGRAPH is a description of the filtergraph to apply to the input audio. Use the option "-filters" to show all the available filters (including sources and sinks).

-i INPUT_FILE
     Read INPUT_FILE.

Advanced options
================

-pix_fmt FORMAT
     Set pixel format. This option has been deprecated in favor of private options, try -pixel_format.

-stats
     Print several playback statistics, in particular show the stream duration, the codec parameters, the current position in the stream and the audio/video synchronisation drift. It is on by default, to explicitly disable it you need to specify -nostats.

-fast
     Non-spec-compliant optimizations.

-genpts
     Generate pts.

-sync TYPE
     Set the master clock to audio (type=audio), video (type=video) or external (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.

-ast AUDIO_STREAM_SPECIFIER
     Select the desired audio stream using the given stream specifier. The stream specifiers are described in the Stream specifiers chapter. If this option is not specified, the "best" audio stream is selected in the program of the already selected video stream.

-vst VIDEO_STREAM_SPECIFIER
     Select the desired video stream using the given stream specifier. The stream specifiers are described in the Stream specifiers chapter. If this option is not specified, the "best" video stream is selected.

-sst SUBTITLE_STREAM_SPECIFIER
     Select the desired subtitle stream using the given stream specifier. The stream specifiers are described in the Stream specifiers chapter. If this option is not specified, the "best" subtitle stream is selected in the program of the already selected video or audio stream.

-autoexit
     Exit when video is done playing.

-exitonkeydown
     Exit if any key is pressed.

-exitonmousedown
     Exit if any mouse button is pressed.

-codec:MEDIA_SPECIFIER CODEC_NAME
     Force a specific decoder implementation for the stream identified by MEDIA_SPECIFIER, which can assume the values a (audio), v (video), and s subtitle.

-acodec CODEC_NAME
     Force a specific audio decoder.

-vcodec CODEC_NAME
     Force a specific video decoder.

-scodec CODEC_NAME
     Force a specific subtitle decoder.

-autorotate
     Automatically rotate the video according to presentation metadata. Enabled by default, use -noautorotate to disable it.

-framedrop
     Drop video frames if video is out of sync. Enabled by default if the master clock is not set to video. Use this option to enable frame dropping for all master clock sources, use -noframedrop to disable it.

-infbuf
     Do not limit the input buffer size, read as much data as possible from the input as soon as possible. Enabled by default for realtime streams, where data may be dropped if not read in time. Use this option to enable infinite buffers for all inputs, use -noinfbuf to disable it.

While playing
=============

q, ESC
     Quit.

f
     Toggle full screen.

p, SPC
     Pause.

a
     Cycle audio channel in the current program.

v
     Cycle video channel.

t
     Cycle subtitle channel in the current program.

c
     Cycle program.

w
     Cycle video filters or show modes.

s
     Step to the next frame.

     Pause if the stream is not already paused, step to the next video frame, and pause.

left/right
     Seek backward/forward 10 seconds.

down/up
     Seek backward/forward 1 minute.

page down/page up
     Seek to the previous/next chapter. or if there are no chapters Seek backward/forward 10 minutes.

mouse click
     Seek to percentage in file corresponding to fraction of width.

     [file config.texi not included]

See Also
********

ffmpeg(1), ffprobe(1), ffserver(1), ffmpeg-utils(1), ffmpeg-scaler(1), ffmpeg-resampler(1), ffmpeg-codecs(1), ffmpeg-bitstream-filters(1), ffmpeg-formats(1), ffmpeg-devices(1), ffmpeg-protocols(1), ffmpeg-filters(1)

     [file authors.texi not included]