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

-an
     Disable audio.

-vn
     Disable video.

-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 FILTER_GRAPH
     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).

-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
     Show the stream duration, the codec parameters, the current position in the stream and the audio/video synchronisation drift.

-bug
     Work around bugs.

-fast
     Non-spec-compliant optimizations.

-genpts
     Generate pts.

-rtp_tcp
     Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful if you are streaming with the RTSP protocol.

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

-threads COUNT
     Set the thread count.

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

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

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

-autoexit
     Exit when video is done playing.

-exitonkeydown
     Exit if any key is pressed.

-exitonmousedown
     Exit if any mouse button is pressed.

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

q, ESC
     Quit.

f
     Toggle full screen.

p, SPC
     Pause.

a
     Cycle audio channel.

v
     Cycle video channel.

t
     Cycle subtitle channel.

w
     Show audio waves.

left/right
     Seek backward/forward 10 seconds.

down/up
     Seek backward/forward 1 minute.

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

     [file eval.texi not included]
     [file decoders.texi not included]
     [file demuxers.texi not included]
     [file muxers.texi not included]
     [file indevs.texi not included]
     [file outdevs.texi not included]
     [file protocols.texi not included]
     [file filters.texi not included]