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/⟩