Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

oggcat(1) [debian man page]

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 the-
	      ora 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)

Check Out this Related Man Page

OGGCUT(1)							   User Manuals 							 OGGCUT(1)

NAME

       oggCut - extracts parts of an ogg file (.ogv, .ogg and .oga)

SYNOPSIS

       oggCut [options] inputfile outputfile

DESCRIPTION

       oggCut creates a new ogg file named outputfile as a subpart of the original file named inputfile

       oggCut is able to cut video (theora) only files, audio (vorbis) only files or files with both video and audio streams.

       The start and end time for the cut area must be given in milliseconds with the options -s and -e.

       As  a video stream consists of I-frames (which are full pictures) and P-frames (which are delta pictures to the leading I-frame) the oggCut
       algorithm searches for the first I-frame. If a video file would start with a p-frame, the player is not able to interpret this picture,	as
       the leading I-frame (on where it is based) is not available.  oggCut starts the I-frame search at the start time given by the -s option. So
       expect a shorter video time than the calculated seconds for the new file.

       oggCut does not do any reencoding, therefore the output quality is completely the same as from the input file.

       For those involved into the ogg container format: The file is cut on packet basis, not on page basis.

       There is another tool called oggCut out in the internet with a different synopis. This one has not been written by the author of this  tool
       you are actually using.

OPTIONS

       -s     Cut start position in ms. If the input file is a video file, the cut area starts with the next keyframe found. Default: 0

	      Example: -s 5000

       -l     Length of the cut area in ms. If -e is also given, the length is ignored.

	      Example: -l 10000

       -e     Cut end position in ms. If -l is also used, the end position is prefered. If the end position is set to -1, the end of the stream is
	      assumed.

	      Default: -1

	      Example: -e 20000

EXAMPLE

       oggCut -s 1000 -e 21000 myVideo.ogv myOutput.ogv

       Creates a new video called myOutput.ogv from the video myVideo.ogv starting after 1 second ending after 21 seconds

AUTHOR

       Joern Seger <yorn at gmx dot net>

SEE ALSO

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

Linux								     JAN 2010								 OGGCUT(1)
Man Page