FFPLAY(1)

NAME
ffplay - FFplay media player

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

  Generic options
These options are shared amongst the ff* tools.

-L  Show license.

-h, -?, -help, --help
    Show help.

-version
    Show version.

-formats
    Show available formats.

    The fields preceding the format names have the following meanings:

    D   Decoding available

    E   Encoding available

-codecs
    Show available codecs.

    The fields preceding the codec names have the following meanings:

    D   Decoding available

    E   Encoding available

    V/A/S
        Video/audio/subtitle codec

    S   Codec supports slices

    D   Codec supports direct rendering

    T   Codec can handle input truncated at random locations instead of only at frame boundaries

-bsfs
    Show available bitstream filters.

-protocols
    Show available protocols.

-filters
    Show available libavfilter filters.

-pix_fmts
    Show available pixel formats.

-loglevel loglevel
    Set the logging level used by the library. loglevel is a number or a string containing one of the following values:

    quiet
    panic
    fatal
    error
    warning
    info
    verbose
    debug

  Main options

-x width
    Force displayed width.

-y height
    Force displayed height.

-s size
    Set frame size (WxH or abbreviation), needed for videos which don't contain a header with the frame size like raw YUV.

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

  Advanced options

-pix_fmt format
    Set pixel format.

-stats
    Show the stream duration, the codec parameters, the current position in the stream and the audio/video synchronisation drift.

-debug
    Print specific debug info.

-bug
    Work around bugs.

-vismv
    Visualize motion vectors.

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

  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.

SEE ALSO
ffmpeg(1), ffserver(1) and the HTML documentation of ffmpeg.

AUTHOR
Fabrice Bellard