NAME

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

SYNOPSIS

       oggz-merge [-o filename  | --output filename ] filename ...

       oggz-merge [-h  | --help ]  [-v  | --version ]

Description

       oggz-merge  merges  Ogg  files together, interleaving pages in order of presentation time.
       It correctly interprets the granulepos timestamps of Ogg CELT, CMML,  Dirac,  FLAC,  Kate,
       PCM,  Speex,  Theora  and  Vorbis bitstreams.  Run oggz-known-codecs(1) for a full list of
       codecs known by the installed version of oggz.

       For example, if you have an Ogg Theora video file, and its soundtrack stored separately as
       an Ogg Speex audio file, and you can use oggz-merge to create a single Ogg file containing
       the video and audio, interleaved together in parallel.

       Similarly, using oggz-merge on a collection of Ogg Vorbis audio files will  create  a  big
       Ogg file with all the songs in parallel, ie. interleaved for simultaneous playback. Such a
       file is proper Ogg, but not "Ogg Vorbis I" -- the Ogg Vorbis I  specification  defines  an
       Ogg Vorbis file as an Ogg file containing only one Vorbis track at a time (ie. no parallel
       multiplexing). Many music players  (which  use  libvorbisfile)  aren't  designed  to  play
       multitrack  Ogg  files.   In  general  however,  video  players,  and  anything built on a
       multimedia framework (like GStreamer, DirectShow etc.) will probably  be  able  to  handle
       such files.

       If  you  want to create a file containing some Ogg files sequenced one after another, then
       you should simply concatenate them together using cat. In Ogg this is  called  "chaining".
       If you cat Ogg Vorbis I audio files together, then the result will also be a compliant Ogg
       Vorbis file.

Options

       oggz-merge accepts the following options:

   Miscellaneous options
       -o filename, --output filename
                 Write output to the specified  filename  instead  of  printing  it  to  standard
                 output.

       -h, --help
                 Display usage information and exit.

       -v, --version
                 Output version information and exit.

EXAMPLES

       Merge pages of audio.oga and video.ogv:

              oggz merge -o output.ogv audio.oga video.ogv

AUTHOR

       Conrad Parker        September 21, 2004;

COPYRIGHT

       Copyright © 2004 CSIRO Australia

SEE ALSO

       cat(1), oggz-rip(1), oggz-dump(1), oggz-diff(1), hogg(1)

                                                                                    oggz-merge(1)