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

  
 
  

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

NAME
     oggz-sort -- Sort the pages of an Ogg file in order of presentation time.

SYNOPSIS
     oggz-sort [-o filename  | --output filename ] filename

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

Description
     oggz-sort	sorts  an  Ogg file, interleaving pages in order of presentation
     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.

     Some encoders produce files with incorrect page ordering; for example, some
     audio and video pages may occur out of order. Although these files are usu-
     ally playable, it can be difficult to accurately seek or scrub on them, in-
     creasing the likelihood of glitches during playback.  Players may also need
     to use more memory in order to buffer the audio and video data for synchro-
     nized playback, which can be a problem when the files are	viewed	on  low-
     memory devices.

     Some  older Ogg encoders also produce pages which incorrectly have granule-
     pos timestamps recorded that shouldn't be: pages which  have  no  completed
     packets must have a granulepos of -1.  oggz-sort will correct such granule-
     pos during the process of sorting.

     The  tool oggz-validate can be used to check the relative ordering of pack-
     ets in a file, and also to detect incorrect granulepos  on  pages	with  no
     completed packets. If either of these errors are reported, or use oggz-sort
     to fix the problem.

Options
     oggz-sort 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
     Correct the page ordering in broken.ogv:

	    oggz sort -o fixed.ogv broken.ogv

AUTHOR
     Conrad Parker	  January 25, 2008;

COPYRIGHT
     Copyright (C) 2008 Annodex Association

SEE ALSO
     oggz-validate(1), oggz-merge(1), oggz-dump(1), oggz-diff(1), hogg(1)

								    oggz-sort(1)

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

home | help