Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
oggz-merge(1)		     General Commands Manual		   oggz-merge(1)

NAME
     oggz-merge -- Merge Ogg files together, interleaving pages in order of pre-
     sentation 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 pre-
     sentation time.  It correctly interprets the granulepos timestamps  of  Ogg
     CELT,  CMML,  Dirac,  FLAC,  Kate, Opus, PCM, Speex, Theora, Vorbis and VP8
     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  to-
     gether 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 multi-
     track  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, --helpDisplay 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=oggz-merge&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help