NAME

       oggCat - concatenates two or more ogg files

SYNOPSIS

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

DESCRIPTION

       oggCat  concatenates two or more ogg files (.ogv, .ogg or oga), that contain theora and/or
       vorbis streams.

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

       All  subsequent  files  that  does  not  match  these  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 and myfile3.ogv

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

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

AUTHOR

       Joern Seger <yorn at gmx dot net>

SEE ALSO

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