ffmpeg2theora  -  command-line  converter  to create Ogg Theora and Ogg
   Vorbis files.


   ffmpeg2theora [options] inputfile


   This manual page documents briefly the ffmpeg2theora command.

   ffmpeg2theora is a program that converts any media file that ffmpeg can
   decode to Ogg Theora for video and Ogg Vorbis for audio.


   To read from standard input, specify `-' as the input filename.

   These  programs  follow  the  usual  GNU command line syntax, with long
   options starting with two  dashes  (`-').   A  summary  of  options  is
   included below.

   General output options:
   -o, --output
          Specify   the   output  filename.   If  no  output  filename  is
          specified, output will be written to inputfile.ogv.   To  output
          to standard output, specify /dev/stdout as the output file.

          Disables Ogg Skeleton metadata output.

          Enables keyframe index in skeleton track.

   -s, --starttime
          Start encoding at this time (in seconds).

   -e, --endtime
          End encoding at this time (in seconds).

   -p, --preset
          Encode  file  with v2v preset.  Right now, there is preview, pro
          and videobin.  Run "ffmpeg2theora -p info" for more information.

   Video output options:
   -v, --videoquality
          [0 to 10] Set encoding quality for video (default: 6).
                    use higher values for better quality

   -V, --videobitrate
          Set encoding bitrate for video (in kb/s).

          Use a large reservoir and treat the rate as a soft target;  rate
          control   is  less  strict  but  resulting  quality  is  usually
          higher/smoother overall. Soft target also allows an optional  -v
          setting to specify a minimum allowed quality.

          Compress   input  using  two-pass  rate  control.   This  option
          requires that the input to the to the encoder  is  seekable  and
          performs both passes automatically.

   --first-pass <filename>
          Perform  first-pass  of  a  two-pass  rate  controlled encoding,
          saving pass data to <filename> for a later second pass

   --second-pass <filename>
          Perform second-pass of  a  two-pass  rate  controlled  encoding,
          reading  first-pass  data  from <filename>.  The first pass data
          must come from a first encoding pass using identical input video
          to work properly.

          Optimize  output  Theora  video,  using a full search for motion
          vectors instead of a hierarchical one.  This  can  reduce  video
          bitrate  about 5%, but it is slower and therefore is disabled by

          encoding is faster with higher values the cost  is  quality  and
          bandwidth  (default 1) available values depend on the version of
          libtheora check ffmpeg2theora --help for supported values.

   -x, --width
          Scale to given width (in pixels).

   -y, --height
          Scale to given height (in pixels).

          Define frame aspect ratio (e.g. 4:3, 16:9).

          Define pixel aspect ratio (e.g. 1:1, 4:3).

   -F, --framerate
          output framerate e.g 25:2 or 16

   --croptop, --cropbottom, --cropleft, --cropright
          Crop input by given pixels before resizing.

   -K, --keyint
          [8 to 2147483647] Set keyframe interval (default: 64).

   -d, --buf-delay
          Buffer delay (in frames).  Longer  delays  allow  smoother  rate
          adaptation  and provide better overall quality, but require more
          client side buffering and add latency. The default value is  the
          keyframe  interval  for one-pass encoding (or somewhat larger if
          --soft-target is used) and infinite for two-pass encoding. (only
          works in bitrate mode)

          only  scale  video  or  resample  audio  if input is bigger than
          provided parameter

   Video transfer options:
   --pp   Video Postprocessing, denoise, deblock,  deinterlacer  use  --pp
          help for a list of available filters.

   -C, --contrast
          [0.1  to  10.0]  contrast correction (default: 1.0). Note: lower
          values make the video darker.

   -B, --brightness
          [-1.0 to 1.0] brightness correction (default: 0.0). Note:  lower
          values make the video darker.

   -G, --gamma
          [0.1  to  10.0]  gamma  correction  (default:  1.0). Note: lower
          values make the video darker.

   -P, --saturation
          [0.1 to 10.0] saturation correction (default: 1.0). Note:  lower
          values make the video grey.

   Audio output options:
   -a, --audioquality
          [-2 to 10] Set encoding quality for audio (default: 1).
                     use higher values for better quality

   -A, --audiobitrate
          [32 to 500] Set encoding bitrate for audio (in kb/s).

   -c, --channels
          Set number of output channels.

   -H, --samplerate
          Set output samplerate (in Hz).

   Input options:
          Disable audio from input.

          Disable video from input.

          Force deinterlace.  Otherwise only material marked as interlaced
          will be deinterlaced.

          Force deinterlace off.

          you can use ffmpeg's vhook system, example:
           ffmpeg2theora --vhook '/path/watermark.so -f wm.gif' input.dv

   -f, --format
          Specify input format.

          Override input fps.

   --audiostream id
          By default the first audio  stream  is  selected,  use  this  to
          select another audio stream.

   --videostream id
          By  default  the  first  video  stream  is selected, use this to
          select another audio stream.

   --sync Use A/V sync from input container. Since this does not work with
          all  input  format  you  have  to  manualy enable it if you have
          issues with A/V sync.

   Subtitles options:
          Encode subtitles from the  given  file  to  a  multiplexed  Kate
          stream.   The  input  file  should  be  in SubRip (.srt) format,
          encoded in UTF-8, unless the --subtitles-encoding option is also

   --subtitles-encoding encoding
          Assumes the corresponding subtitles file is encoded in the given
          encoding. If ffmpeg2theora was built  with  iconv  support,  all
          encodings  supported  by iconv may be used. Otherwise, UTF-8 and
          ISO-8859-1 (aka latin1) are supported. The default is UTF-8.

   --subtitles-language language
          Sets the language of the corresponding  subtitles  stream.  This
          will  be  set in the corresponding Kate stream so a video player
          may make this available to  the  user  for  language  selection.
          Language is an ISO 639-1 or RFC 3066 ASCII string and is limited
          to 15 characters.

   --subtitles-category category
          Sets the category of the corresponding  subtitles  stream.  This
          will  be  set in the corresponding Kate stream so a video player
          may make this available to the user for selection.  The  default
          category  is "subtitles". Suggested other categories may include
          "transcript", "commentary", "lyrics", etc. Category is an  ASCII
          string and is limited to 15 characters

          When  reading  an  UTF-8  subtitles text file, any invalid UTF-8
          sequence will be ignored. This may be useful if there are  stray
          sequences  in  an  otherwise  UTF-8 file. Note that, since those
          invalid sequences will be removed from the output,  this  option
          is not a substitute to converting a non UTF-8 file to UTF-8.

          Disables  subtitles from input.  Note that subtitles explicitely
          loaded from external files will still be used.

          Selects which subtitle types to include  from  the  input  file.
          Allowed  types  are:  none,  all, text, spu (spu being the image
          based subtitles found on DVD).   By  default,  only  text  based
          subtitles  will  be  included.   Note that subtitles explicitely
          loaded from external files will still be used.

   Metadata options:
          Name of artist (director).


   --date Date.


          Name of organization (studio).



          Contact link.

          disables metadata from input

          do not include oshash of source file(SOURCE_OSHASH)

   Keyframe indexing options:
   --index-interval <n>
          set  minimum  distance  between  indexed  keyframes  to  <n>  ms
          (default: 2000)

   --theora-index-reserve <n>
          reserve <n> bytes for theora keyframe index

   --vorbis-index-reserve <n>
          reserve <n> bytes for vorbis keyframe index

   --kate-index-reserve <n>
          reserve <n> bytes for kate keyframe index

   Other options:
   --nice n
          Set niceness to n.

   -h, --help
          Output a help message.

   --info Output json info about input file, use -o to save json to file.

          print status information in json, one json dict per line


   Encode Videos:
     ffmpeg2theora videoclip.avi (will write output to videoclip.ogv)

     cat something.dv | ffmpeg2theora -f dv -o output.ogv -

   Encode a series of images:
     ffmpeg2theora frame%06d.png -o output.ogv

   Live streaming from V4L Device:
     ffmpeg2theora --no-skeleton /dev/video0 -f video4linux \
                   --inputfps 15 -x 160 -y 128 \
                   -o - | oggfwd icast2server 8000 password /theora.ogv

     (you might have to use video4linux2 depending on your hardware)

   Live encoding from a DV camcorder (needs a fast machine):
     dvgrab - | ffmpeg2theora -f dv -x 352 -y 288 -o output.ogv -0

   Live encoding and streaming to icecast server:
     dvgrab --format raw - \
     | ffmpeg2theora --no-skeleton -f dv -x 160 -y 128 -o /dev/stdout - \
     | oggfwd icast2server 8000 password /theora.ogv


   ffmpeg2theora was written by jan gerber <j@v2v.cc>.

   This manual page was written by Hubert Chan <hubert@uhoreg.ca>, for the
   Debian project (but may be used by others).

                             May 14, 2010                 FFMPEG2THEORA(1)

More Linux Commands

fegetexcept(3) - floating-point rounding and exception handl
These eleven functions were defined in C99, and describe the handling of floating-point rounding and exceptions (overflow, zero-divide, etc.). Exceptions The di

Tcl_GetByteArrayFromObj(3) - manipulate Tcl objects as a arr
These procedures are used to create, modify, and read Tcl byte-array objects from C code. Byte-array objects are typically used to hold the results of binary IO

endmntent(3) - get file system descriptor file entry........
These routines are used to access the filesystem description file /etc/fstab and the mounted filesystem description file /etc/mtab. The setmntent() function ope

objdump(1) - display information from object files..........
objdump displays information about one or more object files. The options control what particular information to display. This information is mostly useful to pr

ttk_combobox(n) text field with popdown selection list......
A ttk::combobox combines a text field with a pop-down list of values; the user may select the value of the text field from among the values in the list. STANDAR

Tcl_LimitGetGranularity(3) - manage and check resource limit
Tcls interpreter resource limit subsystem allows for close control over how much computation time a script may use, and is useful for cases where a program is d

Tcl_NewWideIntObj(3) - manipulate Tcl objects as integer val
These procedures are used to create, modify, and read Tcl objects that &amp;#9474; hold integral values. &amp;#9474; The different routines exist to accommodate differe

dprofpp(1) - display perl profile data - Linux manual page
The dprofpp command interprets profile data produced by a profiler, such as the Devel::DProf profiler. Dprofpp will read the file tmon.out and display the 15 su

mvwchgat(3ncurses) - curses character and window attribute c
These routines manipulate the current attributes of the named window. The current attributes of a window apply to all characters that are written into the windo

mq_open(3) - open a message queue - Linux manual page.......
mq_open() creates a new POSIX message queue or opens an existing queue. The queue is identified by name. For details of the construction of name, see mq_overvie

text2pcap(1) - Generate a capture file from an ASCII hexdump
Text2pcap is a program that reads in an ASCII hex dump and writes the data described into a pcap capture file. text2pcap can read hexdumps with multiple packets

Tcl_DeleteExitHandler(3) - end the application or thread (an
The procedures described here provide a graceful mechanism to end the execution of a Tcl application. Exit handlers are invoked to cleanup the applications stat

We can't live, work or learn in freedom unless the software we use is free.