ogmcat man page

ogmcat — Concatenate several OGG/OGM files into one big OGG/OGM file


ogmcat [options] -o outname inname1 [inname2 [inname3 ...]]


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


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.


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:

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.


ogmcat was written by Moritz Bunkus <moritz@bunkus.org>.

See Also

ogmmerge(1), ogminfo(1), ogmdemux(1), ogmsplit(1), dvdxchap(1)


The newest version can always be found at <http://www.bunkus.org/videotools/ogmtools/>

Referenced By

ogmdemux(1), ogminfo(1), ogmmerge(1), ogmsplit(1).

November 2004 ogmcat v1.5 User Commands