oggz-merge(1) [debian man page]

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)

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

NAME

       oggz-chop -- Extract the part of an Ogg file between given start and/or end times.

SYNOPSIS

       oggz-chop [-o filename  | --output filename ]  [-s start_time  | --start start_time ]  [-e end_time  | --end end_time ]	[-k  | --no-skele-
       ton ] filename

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

Description
       oggz-chop chops a section of an Ogg file.  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.

       The  output  file contains copies of the headers of the input file, and all the codec data required to correctly decode the content between
       the start and end times specified on the commandline. For codecs with data dependencies like video keyframes, the  keyframe  prior  to  the
       starting time will be included in the output.

       Note  that  oggz-chop operates by copying pages of Ogg data; it does not strip partial packets from the first or last data page included in
       the output. It does however ensure to set the end of stream flag on the last page of each logical bitstream.

       Skeleton handling: By default, the output will contain a Skeleton track specifying the start of the chop as presentation time.

Options
       oggz-chop accepts the following options:

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

       -s start_time, --start start_time
		 Specify the start time of the chopped section to output.

       -e end_time, --end end_time
		 Specify the end time of the chopped section to output.

       -k , --no-skeleton
		 Do NOT include a Skeleton bitstream in the output.

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

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

EXAMPLES

       Extract the first minute of file.ogx:

	      oggz chop -e 1:00 file.ogx

       Extract from the second to the fifth minute of file.ogx:

	      oggz chop -s 2:00 -e 5:00 -o output.ogx file.ogx

       Extract, specifying SMPTE-25 frame offsets:

	      oggz chop -s smpte-25:00:02:03::12 -e smpte-25:00:05:02::04 -o output.ogv file.ogv

Server configuration
       The following configuration for Apache httpd will enable oggz-chop. As with most Apache directives, this may of	course	be  restricted	to
       particular Directories or Locations:

       ScriptAlias /oggz-chop /usr/bin/oggz-chop

       Action application/ogg /oggz-chop

   HTTP/1.1 Cacheability
       oggz-chop generates Last-Modified HTTP headers, and responds correctly to If-Modified-Since conditional GET requests.

AUTHOR

       Conrad Parker	    February 25, 2008;

COPYRIGHT

       Copyright (C) 2008 Annodex Association

SEE ALSO

       oggz-validate(1), oggz-merge(1), oggz-dump(1), hogg(1)

																      oggz-chop(1)