1oggz-merge(1)               General Commands Manual              oggz-merge(1)
2
3
4

NAME

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

SYNOPSIS

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

Description

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

Options

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

EXAMPLES

65       Merge pages of audio.oga and video.ogv:
66
67              oggz merge -o output.ogv audio.oga video.ogv
68
69

AUTHOR

71       Conrad Parker        September 21, 2004;
72

74       Copyright © 2004 CSIRO Australia
75
76

SEE ALSO

78       cat(1), oggz-rip(1), oggz-dump(1), oggz-diff(1), hogg(1)
79
80
81
82                                                                 oggz-merge(1)
Impressum