FFMPEG2THEORA(1)					      General Commands Manual						  FFMPEG2THEORA(1)

NAME

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

SYNOPSIS

       ffmpeg2theora [options] inputfile

DESCRIPTION

       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.

OPTIONS

       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.

       --no-skeleton
	      Disables Ogg Skeleton metadata output.

       --seek-index
	      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).

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

       --two-pass
	      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
	      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 default.

       --speedlevel
	      encoding is faster with higher values the cost is quality and bandwidth
	       0: Slowest (best)
	       1: Enable early skip (default)
	       2: Disable motion compensation

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

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

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

       --pixel-aspect
	      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-tar-
	      get is used) and infinite for two-pass encoding. (only works in bitrate mode)

       --no-upscaling
	      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:
       --noaudio
	      Disable audio from input.

       --novideo
	      Disable video from input.

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

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

       -f, --format
	      Specify input format.

       --inputfps
	      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:
       --subtitles
	      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 given.

       --subtitles-encoding encoding
	      Assumes the corresponding subtitles file is encoded in the given encoding. If ffmpeg2theora was built with iconv support, all encod-
	      ings 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 char-
	      acters.

       --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 "tran-
	      script", "commentary", "lyrics", etc. Category is an ASCII string and is limited to 15 characters

       --subtitles-ignore-non-utf8
	      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.

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

       --subtitle-types
	      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:
       --artist
	      Name of artist (director).

       --title
	      Title.

       --date Date.

       --location
	      Location.

       --organization
	      Name of organization (studio).

       --copyright
	      Copyright.

       --license
	      License.

       --contact
	      Contact link.

       --nometadata
	      disables metadata from input

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

       --frontend
	      print status information in json, one json dict per line

EXAMPLES

       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 /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 -f dv -x 160 -y 128 -o /dev/stdout - 
	   | oggfwd icast2server 8000 password /theora.ogv

AUTHOR

       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)