ffmpeg2theora 0.15

 usage: ffmpeg2theora [options] input

Output options:
         --output,-o            alternative output
         --width, -x            scale to given size
         --height,-y            scale to given size
         --aspect               define frame aspect ratio: i.e. 4:3 or 16:9
         --crop[top|bottom|left|right]  crop input before resizing
         --videoquality,-v      [0 to 10]    encoding quality for video
         --videobitrate,-V      [45 to 2000] encoding bitrate for video
         --sharpness,-S         [0 to 2]     sharpness of images(default 2)
                                   { lower values make the video sharper. }
         --keyint,-K            [8 to 65536] keyframe interval (default: 64)
         --audioquality,-a      [-1 to 10]   encoding quality for audio
         --audiobitrate,-A      [45 to 2000] encoding bitrate for audio
         --samplerate,-H        set output samplerate in Hz
         --channels,-c          set number of output sound channels
         --nosound              disable the sound from input
         --endtime,-e           end encoding at this time (in sec)
         --starttime,-s         start encoding at this time (in sec)
         --v2v-preset,-p        encode file with v2v preset, 
                                 right now there is preview and pro,
                                 'ffmpeg2theora -p info' for more informations

Input options:
         --deinterlace  force deinterlace
                                 otherwise only material marked as interlaced 
                                 will be deinterlaced
         --format,-f            specify input format
         --v4l   /dev/video0    read data from v4l device /dev/video0
                                you have to specifiy an output file with -o
         --inputfps [fps]       override input fps
         --audiostream streamid by default the last audiostream 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      Licence

Other options:
         --nice                 set niceness to n
         --help,-h              this message

 Examples:
        ffmpeg2theora videoclip.avi (will write output to videoclip.ogg)

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

        Live streaming from V4L Device:
         ffmpeg2theora --v4l /dev/video0 --inputfps 15 -x 160 -y 128 -o - \ 
                 | oggfwd iccast2server 8000 password /theora.ogg

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

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