DragonFly On-Line Manual Pages

OGGCAT(1)                        User Manuals                        OGGCAT(1)

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 seperator.

              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 seperator.

              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 reencode the video stream. This is sometimes
              neccessary, 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)

Linux                              JAN 2010                          OGGCAT(1)