1OGMCAT(1) User Commands OGMCAT(1)
2
6 ogmcat - Concatenate several OGG/OGM files into one big OGG/OGM file
7
9 ogmcat [options] -o outname inname1 [inname2 [inname3 ...]]
10
12 ogmcat does NOT work at the moment. It is work in progress. I included
13 it just out of laziness (otherwise I'd have to remove it from the Make‐
14 file/configure stuff prior to releasing this version).
15 ogmcat can be used to concatenate several OGG/OGM files into one big
17 file if they are of the same type. For a more in-depth description
18 refer to the LIMITATIONS section.
19 -o, --output outname
21 Output to 'outname'.
22 inname1
24 Use 'inname1', 'inname2' etc as the sources.
25 -m, --manualsync n
27 Specifies a manual sync value in ms that will be added to each
28 stream's presentation timestamps along with the value calculated
29 by the chosen sync algorithm (see the -s option). This option
30 can be used for each input file although it has no effect if
31 used for the first one as well.
32 -s, --sync nr
34 Uses sync mode nr. Valid values are 0 - 4. The default value is
35 shown on ogmcat's help screen.
36 -n, --nosafetychecks
38 Disable the safety checks made prior to the concatenating. The
39 resulting file may be unplayable. See the LIMITATIONS section
40 for further details.
41 -v, --verbose
43 Be verbose and show each OGG packet. Can be used twice to
44 increase verbosity.
45 -h, --help
47 Show this help.
48 -V, --version
50 Show version information.
51
53 Concatenating streams is difficult at the best and might even be impos‐
54 sible. Therefore ogmcat makes very strict comparisons between the
55 streams contained in the input files. The checks done include:
56 * general: All streams with the same serial number must be of the
58 same type (video, audio, Vorbis audio or text streams).
59 * general: If a stream exists in one file it must in the other
61 files as well.
62 * video streams: The codec FourCC, width, height and FPS must
64 match.
65 * Vorbis streams: The sample rate and the number of channels must
67 match.
68 * other audio streams: The codec ID, sample rate, bits per sample
70 and number of channels must match.
71 * text/subtitle streams: The 'time unit' must match.
73 The user can forcefully override the last four checks with the -n
75 parameter. The checks marked as 'general' cannot be overridden this
76 way.
77 Audio/video synchronization might not be ok in the resulting file even
79 if the source files were perfectly in sync. The user can experiment
80 with the -s parameter which causes ogmcat to use slightly different
81 algorithms for calculating the granulepos values for the audio and text
82 streams. The range of valid parameters will be printed on ogmcat's help
83 screen.
84 If none of the synchronization algorithms provided works correctly then
86 the user can also manually add a synchronization offset using the -m
87 option for each input file.
88
90 ogmcat was written by Moritz Bunkus <moritz@bunkus.org>.
91
93 ogmmerge(1), ogminfo(1), ogmdemux(1), ogmsplit(1), dvdxchap(1)
94
96 The newest version can always be found at
97 <http://www.bunkus.org/videotools/ogmtools/>
98 ⟨http://www.bunkus.org/videotools/ogmtools/⟩
99ogmcat v1.5 November 2004 OGMCAT(1)