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, 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 (C) 2008 Annodex Association