Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
OGGCAT(1)			  User Manuals			       OGGCAT(1)

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,  ex-
     plained below.

     All subsequent files that does not match these file parameters are automat-
     ically transcoded.

     A concatenation will fail in case that there are not enought streams avail-
     able.  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 (the-
	    ora). 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  (vor-
	    bis).  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 denomi-
	    nator 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  com-
	    ment  can be concatenated with a semicolon. It is recommended to use
	    apostrophes as the command line may use the semicolon as  a  sepera-
	    tor.

	    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  com-
	    ment  can be concatenated with a semicolon. It is recommended to use
	    apostrophes as the command line may use the semicolon as  a  sepera-
	    tor.

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

     -q     Specifies the video quality for the newly created stream. Valid val-
	    ues 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 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 con-
     catFile.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), og-
     gThumb(1), oggSilence(1)

Linux				    JAN 2010			       OGGCAT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=oggCat&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help