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