Provided by: oggvideotools_0.9.1-6_amd64 bug

NAME

       oggTranscode - transcodes ogg files in multiple ways

SYNOPSIS

       oggTranscode [options] inputfile.ogv outputfile.ogv

DESCRIPTION

       oggTranscode  can  resize  an  ogg file (ogg, oga or ogv) in multiple ways: It can change the video frame
       size, change datarate for the video and/or audio streams contained in the ogg file and it can also change
       the video frame rate or audio sample rate.

       Additionally, since version 0.8 oggTranscode can add any ogg  comment  and  png‐pictures  with  an  alpha
       channel can be rendered into the video at any time period before and after the resizing process.

       oggTranscode was previously called oggResize.

OPTIONS

       -s     Sets  the  size  of the video frame. The size is given as <width>x<height>.  At default, the video
              frame size keeps the same.

              Example: -s 320x240

       -d     Sets the datarate in byte per seconds for the video encoder (theora). This meant  to  be  a  upper
              threshold.  So  the  file  may  be  smaller than assumed. If not set, the datarate of the original
              stream is used.

              Example: -d 1024000

       -D     Sets the datarate in byte per seconds for the audio encoder (vorbis).  If not set, the datarate of
              the original stream is used.

              Example: -D 64000

       -f     Sets the frame rate of the video with numinator and demoninator and is the pictures per second. If
              only one number is given, the denominator is set to 1. If not set, the framerate of  the  original
              video is used.

              Example: -f 25:2

       -F     Sets  the  sample frequency (sample rate) of the audio data in Hertz. If the sample frequency does
              not match the one with the original file, resamling is invoked.

              Example: -F 32000

       -c

              Adds comments to the video (theora) stream. Comments are given by a pair of type and value in  the
              form  'type=value'.  More than one comment can be concatenated with a semicolon. It is recommended
              to use apostrophes as the command line may use the semicolon as a separator.

              Example: -c 'AUTHOR=yorn;DATE=03.07.09'

       -C     Adds comments to the audio (vorbis) stream. Comments are given by a pair of type and value in  the
              form  'type=value'.  More than one comment can be concatenated with a semicolon. It is recommended
              to use apostrophes as the command line may use the semicolon as a separator.

              Example: -C 'AUTHOR=yorn;DATE=03.07.09'

       -q     Specifies the quality for the resizing process. Values can be chosen between 1 (best quality, with
              slight bluring) and 6 (worst quality). The default value is 2.

              Example: -q1

       -p     This option is meant to help creating a preview of a film.  The  number  given  with  this  option
              defines  the number of frames, that are omitted. E.g.  if a film has 24 frames per second and -p24
              is given, the newly created video shows the video 24 times faster as  only  every  24th  frame  is
              used.  This option can be combined with the option -f to control the framerate.  With both options
              nice video previews can be created. If -p is used, the audio stream is ignored.

              Example: -p 24

       -a     Adds  a  picture  to  the  video  frame  before  it  is  resized.   The expression for the picture
              appearances:

              <picture1.png>[,<startTime>[,<endTime>[,s]]]

              startTime in seconds - value can be a floating point.  Default startTime is 0

              endTime in seconds - value can be a floating point.  default endTime is -1, which is  the  end  of
              the stream duration

              default s ist not set. If s is set, the picture slides in smoothly.

              More  than  one  picture  can  be included.  To concatenate the expressions use the colon.  If the
              appearance time overlap, the pictures are placed on one another, so the last picture is the uppest
              layer.

              Example: -a etwas.png,2,7,s:etwasneues.png,5,10

       -A     Adds a picture to the video frame after it is resized.

              The syntax follows the same expression as with option -a.

EXAMPLE

       oggTranscode -s320x240 -d512000 orig.ogv new.ogv

       Converts a the video orig.ogv to the video new.ogv with the new frame size 320x240. If there was an audio
       stream within the orig.ogv file, it is copied into the new file.

       oggTranscode -D64000 -F16000 -N1 orig.ogv new.ogv

       Converts only the audio stream of file orig.ogv to a sample rate of 16kHz, a datarate of 64 kBit/s and  a
       mono channel.  The video stream is copied as is.

       oggTranscode -s300x200 -D32000 -d1024000 -A etwas.png,2,7,s:etwasneues.png,5,10 orig.ogv new.ogv

       Converts the audio and video stream and adds the alpha channel picture etwas.png to the video from second
       2  to second 7 with a smooth fade in and fade out.  Additionally the alpha channel picture etwasneues.png
       is placed on top of the video frame from second 5 to second 10 without any fading.

AUTHOR

       Joern Seger <yorn at gmx dot net>

SEE ALSO

       oggCut(1), oggCat(1), oggJoin(1), oggSplit(1), oggSlideshow(1), oggThumb(1), oggSilence(1)

Linux                                               JAN 2010                                     OGGTRANSCODE(1)