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.ogg. To output to standard output, specify /dev/stdout as the output file.

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

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

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

  Video output options:

-v, --videoquality
    [0 to 10] Set encoding quality for video (default: 5).

-V, --videobitrate
    [1 to 16778] Set encoding bitrate for video (in kb/s).

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

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

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

-S, --sharpness
    [0 to 2] Sharpness of images (default: 2). Note: lower values make the video sharper.

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

  Audio output options:

-a, --audioquality
    [-2 to 10] Set encoding quality for audio (default: 1).

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

--nosound
    Disable the sound from input.

  Input options:

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

--v4l /dev/video0
    read data from v4l device /dev/video0, you have to specify an output file with -o.

--inputfps
    Override input fps.

--audiostream id
    By default the last audio 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.

  Metadata options:

--artist
    Name of artist (director).

--title
    Title.

--date
    Date.

--location
    Location.

--organization
    Name of organization (studio).

--copyright
    Copyright.

--license
    License.

  Other options:

--nice n
    Set niceness to n.

-h, --help
    Output a help message.

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