1oggzmerge(1)                General Commands Manual               oggzmerge(1)
2
3
4

NAME

6       oggzmerge  —  Merge  Ogg files together, interleaving pages in order of
7       presentation time.
8
9

SYNOPSIS

11       oggzmerge [-o filename  | --output filename ] filename ...
12
13       oggzmerge [-h  | --help ]  [-v  | --version ]
14

Description

16       oggzmerge merges Ogg files together, interleaving  pages  in  order  of
17       presentation time. It correctly interprets the granulepos timestamps of
18       Ogg Vorbis, Speex, FLAC and Theora bitstreams, and  all  bitstreams  of
19       Annodex files.
20
21
22       For  example,  if you have an Ogg Theora video file, and its soundtrack
23       stored separately as an Ogg Speex audio file, and you can use oggzmerge
24       to create a single Ogg file containing the video and audio, interleaved
25       together in parallel.
26
27
28       Similarly, using oggzmerge on a collection of Ogg  Vorbis  audio  files
29       will  create  a big Ogg file with all the songs in parallel, ie. inter‐
30       leaved for simultaneous playback. Such a file is proper  Ogg,  but  not
31       "Ogg  Vorbis I" -- the Ogg Vorbis I specification defines an Ogg Vorbis
32       file as an Ogg file containing only one Vorbis track at a time (ie.  no
33       parallel  multiplexing).  Many  music players (which use libvorbisfile)
34       aren't designed to play multitrack  Ogg  files.   In  general  however,
35       video  players,  and  anything  built  on  a multimedia framework (like
36       GStreamer, DirectShow etc.) will probably be able to handle such files.
37
38
39       If you want to create a file containing some Ogg  files  sequenced  one
40       after  another,  then you should simply concatenate them together using
41       cat. In Ogg this is called "chaining". If you cat Ogg  Vorbis  I  audio
42       files  together,  then  the  result will also be a compliant Ogg Vorbis
43       file.
44
45

Options

47       oggzmerge accepts the following options:
48
49
50   Miscellaneous options
51       -o filename, --output filename
52                 Write output to the specified filename instead of printing it
53                 to standard output.
54
55
56       -h, --help
57                 Display usage information and exit.
58
59       -v, --version
60                 Output version information and exit.
61

AUTHOR

63       Conrad Parker        September 21, 2004;
64

66       Copyright © 2004 CSIRO Australia
67
68

SEE ALSO

70       cat(1), oggzrip(1), oggzdump(1), oggzdiff(1), hogg(1)
71
72
73
74                                                                  oggzmerge(1)
Impressum