git.sesse.net Git - ffmpeg/blob - doc/ffplay-doc.texi

   1 \input texinfo @c -*- texinfo -*-
   2
   3 @settitle FFplay Documentation
   4 @titlepage
   5 @sp 7
   6 @center @titlefont{FFplay Documentation}
   7 @sp 3
   8 @end titlepage
   9
  10 @chapter Synopsis
  11
  12 @example
  13 @c man begin SYNOPSIS
  14 ffplay [options] @file{input_file}
  15 @c man end
  16 @end example
  17
  18 @chapter Description
  19 @c man begin DESCRIPTION
  20
  21 FFplay is a very simple and portable media player using the FFmpeg
  22 libraries and the SDL library. It is mostly used as a testbed for the
  23 various FFmpeg APIs.
  24 @c man end
  25
  26 @chapter Options
  27 @c man begin OPTIONS
  28
  29 @include fftools-common-opts.texi
  30
  31 @section Main options
  32
  33 @table @option
  34 @item -x @var{width}
  35 Force displayed width.
  36 @item -y @var{height}
  37 Force displayed height.
  38 @item -s @var{size}
  39 Set frame size (WxH or abbreviation), needed for videos which don't
  40 contain a header with the frame size like raw YUV.
  41 @item -an
  42 Disable audio.
  43 @item -vn
  44 Disable video.
  45 @item -ss @var{pos}
  46 Seek to a given position in seconds.
  47 @item -t @var{duration}
  48 play <duration> seconds of audio/video
  49 @item -bytes
  50 Seek by bytes.
  51 @item -nodisp
  52 Disable graphical display.
  53 @item -f @var{fmt}
  54 Force format.
  55 @item -window_title @var{title}
  56 Set window title (default is the input filename).
  57 @item -loop @var{number}
  58 Loops movie playback <number> times. 0 means forever.
  59 @item -vf @var{filter_graph}
  60 @var{filter_graph} is a description of the filter graph to apply to
  61 the input video.
  62 Use the option "-filters" to show all the available filters (including
  63 also sources and sinks).
  64
  65 @end table
  66
  67 @section Advanced options
  68 @table @option
  69 @item -pix_fmt @var{format}
  70 Set pixel format.
  71 @item -stats
  72 Show the stream duration, the codec parameters, the current position in
  73 the stream and the audio/video synchronisation drift.
  74 @item -debug
  75 Print specific debug info.
  76 @item -bug
  77 Work around bugs.
  78 @item -vismv
  79 Visualize motion vectors.
  80 @item -fast
  81 Non-spec-compliant optimizations.
  82 @item -genpts
  83 Generate pts.
  84 @item -rtp_tcp
  85 Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
  86 if you are streaming with the RTSP protocol.
  87 @item -sync @var{type}
  88 Set the master clock to audio (@code{type=audio}), video
  89 (@code{type=video}) or external (@code{type=ext}). Default is audio. The
  90 master clock is used to control audio-video synchronization. Most media
  91 players use audio as master clock, but in some cases (streaming or high
  92 quality broadcast) it is necessary to change that. This option is mainly
  93 used for debugging purposes.
  94 @item -threads @var{count}
  95 Set the thread count.
  96 @item -ast @var{audio_stream_number}
  97 Select the desired audio stream number, counting from 0. The number
  98 refers to the list of all the input audio streams. If it is greater
  99 than the number of audio streams minus one, then the last one is
 100 selected, if it is negative the audio playback is disabled.
 101 @item -vst @var{video_stream_number}
 102 Select the desired video stream number, counting from 0. The number
 103 refers to the list of all the input video streams. If it is greater
 104 than the number of video streams minus one, then the last one is
 105 selected, if it is negative the video playback is disabled.
 106 @item -sst @var{subtitle_stream_number}
 107 Select the desired subtitle stream number, counting from 0. The number
 108 refers to the list of all the input subtitle streams. If it is greater
 109 than the number of subtitle streams minus one, then the last one is
 110 selected, if it is negative the subtitle rendering is disabled.
 111 @end table
 112
 113 @section While playing
 114
 115 @table @key
 116 @item q, ESC
 117 Quit.
 118
 119 @item f
 120 Toggle full screen.
 121
 122 @item p, SPC
 123 Pause.
 124
 125 @item a
 126 Cycle audio channel.
 127
 128 @item v
 129 Cycle video channel.
 130
 131 @item t
 132 Cycle subtitle channel.
 133
 134 @item w
 135 Show audio waves.
 136
 137 @item left/right
 138 Seek backward/forward 10 seconds.
 139
 140 @item down/up
 141 Seek backward/forward 1 minute.
 142
 143 @item mouse click
 144 Seek to percentage in file corresponding to fraction of width.
 145
 146 @end table
 147
 148 @c man end
 149
 150 @include filters.texi
 151
 152 @ignore
 153
 154 @setfilename ffplay
 155 @settitle FFplay media player
 156
 157 @c man begin SEEALSO
 158 ffmpeg(1), ffprobe(1), ffserver(1) and the FFmpeg HTML documentation
 159 @c man end
 160
 161 @c man begin AUTHORS
 162 The FFmpeg developers
 163 @c man end
 164
 165 @end ignore
 166
 167 @bye