ogmcat(1) [debian man page]
OGMCAT(1) User Commands OGMCAT(1) NAME
ogmcat - Concatenate several OGG/OGM files into one big OGG/OGM file SYNOPSIS
ogmcat [options] -o outname inname1 [inname2 [inname3 ...]] DESCRIPTION
ogmcat does NOT work at the moment. It is work in progress. I included it just out of laziness (otherwise I'd have to remove it from the Makefile/configure stuff prior to releasing this version). ogmcat can be used to concatenate several OGG/OGM files into one big file if they are of the same type. For a more in-depth description refer to the LIMITATIONS section. -o, --output outname Output to 'outname'. inname1 Use 'inname1', 'inname2' etc as the sources. -m, --manualsync n Specifies a manual sync value in ms that will be added to each stream's presentation timestamps along with the value calculated by the chosen sync algorithm (see the -s option). This option can be used for each input file although it has no effect if used for the first one as well. -s, --sync nr Uses sync mode nr. Valid values are 0 - 4. The default value is shown on ogmcat's help screen. -n, --nosafetychecks Disable the safety checks made prior to the concatenating. The resulting file may be unplayable. See the LIMITATIONS section for further details. -v, --verbose Be verbose and show each OGG packet. Can be used twice to increase verbosity. -h, --help Show this help. -V, --version Show version information. LIMITATIONS
Concatenating streams is difficult at the best and might even be impossible. Therefore ogmcat makes very strict comparisons between the streams contained in the input files. The checks done include: * general: All streams with the same serial number must be of the same type (video, audio, Vorbis audio or text streams). * general: If a stream exists in one file it must in the other files as well. * video streams: The codec FourCC, width, height and FPS must match. * Vorbis streams: The sample rate and the number of channels must match. * other audio streams: The codec ID, sample rate, bits per sample and number of channels must match. * text/subtitle streams: The 'time unit' must match. The user can forcefully override the last four checks with the -n parameter. The checks marked as 'general' cannot be overridden this way. Audio/video synchronization might not be ok in the resulting file even if the source files were perfectly in sync. The user can experiment with the -s parameter which causes ogmcat to use slightly different algorithms for calculating the granulepos values for the audio and text streams. The range of valid parameters will be printed on ogmcat's help screen. If none of the synchronization algorithms provided works correctly then the user can also manually add a synchronization offset using the -m option for each input file. AUTHOR
ogmcat was written by Moritz Bunkus <moritz@bunkus.org>. SEE ALSO
ogmmerge(1), ogminfo(1), ogmdemux(1), ogmsplit(1), dvdxchap(1) WWW
The newest version can always be found at <http://www.bunkus.org/videotools/ogmtools/> <http://www.bunkus.org/videotools/ogmtools/> ogmcat v1.5 November 2004 OGMCAT(1)
Check Out this Related 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)