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,  PCM,
       Speex,  Theora  and Vorbis 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 usually playable, it can be
       difficult to accurately seek or scrub on  them,  increasing  the  likelihood  of  glitches
       during  playback.   Players  may also need to use more memory in order to buffer the audio
       and video data for synchronized 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 granulepos timestamps
       recorded that shouldn't be: pages which have no completed packets must have  a  granulepos
       of -1.  oggz-sort will correct such granulepos during the process of sorting.

       The  tool  oggz-validate  can be used to check the relative ordering of packets 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, --help
                 Display 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 © 2008 Annodex Association

SEE ALSO

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

                                                                                     oggz-sort(1)