1OGMCAT(1)                        User Commands                       OGMCAT(1)
2
3
4

NAME

6       ogmcat - Concatenate several OGG/OGM files into one big OGG/OGM file
7

SYNOPSIS

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

DESCRIPTION

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
16       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
20       -o, --output outname
21              Output to 'outname'.
22
23       inname1
24              Use 'inname1', 'inname2' etc as the sources.
25
26       -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
33       -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
37       -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
42       -v, --verbose
43              Be verbose and show each OGG  packet.   Can  be  used  twice  to
44              increase verbosity.
45
46       -h, --help
47              Show this help.
48
49       -V, --version
50              Show version information.
51

LIMITATIONS

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
57       *      general:  All streams with the same serial number must be of the
58              same type (video, audio, Vorbis audio or text streams).
59
60       *      general: If a stream exists in one file it  must  in  the  other
61              files as well.
62
63       *      video  streams:  The  codec  FourCC,  width, height and FPS must
64              match.
65
66       *      Vorbis streams: The sample rate and the number of channels  must
67              match.
68
69       *      other  audio streams: The codec ID, sample rate, bits per sample
70              and number of channels must match.
71
72       *      text/subtitle streams: The 'time unit' must match.
73
74       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
78       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
85       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

AUTHOR

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

SEE ALSO

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

WWW

96       The      newest      version     can     always     be     found     at
97       <http://www.bunkus.org/videotools/ogmtools/>
98http://www.bunkus.org/videotools/ogmtools/
99
100
101
102ogmcat v1.5                      November 2004                       OGMCAT(1)
Impressum