oggz-merge(1)						      General Commands Manual						     oggz-merge(1)

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. inter-
       leaved 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 (C) 2004 CSIRO Australia

SEE ALSO

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

																     oggz-merge(1)