Available in




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.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 16000] Set encoding bitrate for video (in kb/s).


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


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


Disable the sound from input.

Input options:

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

−f, −−format

Specify input format.

−−v4l /dev/video0

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


Override input fps.

−−audiostream id

By default the last audio stream is selected, use this to select another audio stream.


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:

Name of artist (director).








Name of organization (studio).





Other options:
−−nice n

Set niceness to n.

−h, −−help

Output a help message.


ffmpeg2theora was written by jan gerber <j [AT] v2v.cc>.

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


blog comments powered by Disqus