NAME

       oggCat - concatenates two ogg video files (.ogv, .ogg or oga)

SYNOPSIS

       oggCat [options] outfile.ogv file1.ogv file2.ogv [ file3.ogv [...] ]

DESCRIPTION

       oggCat concatenates two or more ogg files.

       The  parameters  of  the  resulting  ogg file is defined by the first file in the concatenation list. The
       parameters could be changed by some options, explained below.

       All subsequent files that does not match these video file parameters are automatically transcoded.

       A concatenation will fail in case that there are not enought streams available. This could happen e.g. if
       the  first  file  consists  of  one  audio  and one video stream and the second file only carries a video
       stream.

       If there is more than one video or audio stream within the file, the first stream is used.

OPTIONS

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

              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 first file  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 first file 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 first file
              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 video quality for the newly created stream. Valid values can be chosen between 0 and
              63 (best).

              Example: -q 63

       -rv    Force to re-encode the video stream. This is sometimes necessary, if the  video  stream  match  in
              video  parameters,  but not in the theora version. In that case, reencoding the video stream helps
              creating good results.

       -x     Force to overwrite the output file, even if it exists. This is mainly helpful  if  the  oggCat  is
              server controlled.

EXAMPLES

       oggCat concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv

       or

       oggCat -o concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv

       This  command  creates  a  cancatenated  file concatFile.ogv that consists of the three files myfile1.ogv
       myfile2.ogv myfile3.ogv

       oggCat -s320x240 -q63 concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv

       This command connects the three files myfile[1-3].ogv to file concatFile.ogv with the size of 320x240 and
       best quality.

AUTHOR

       Joern Seger <yorn at gmx dot net>

SEE ALSO

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