1oggz-sort(1)                General Commands Manual               oggz-sort(1)
2
3
4

NAME

6       oggz-sort  —  Sort  the  pages  of an Ogg file in order of presentation
7       time.
8
9

SYNOPSIS

11       oggz-sort [-o filename  | --output filename ] filename
12
13       oggz-sort [-h  | --help ]  [-v  | --version ]
14

Description

16       oggz-sort sorts an Ogg file, interleaving pages in order  of  presenta‐
17       tion  time.   It  correctly interprets the granulepos timestamps of Ogg
18       CELT, CMML, Dirac, FLAC, Kate,  PCM,  Speex,  Theora  and  Vorbis  bit‐
19       streams.   Run  oggz-known-codecs(1) for a full list of codecs known by
20       the installed version of oggz.
21
22
23       Some encoders produce files with incorrect page ordering; for  example,
24       some audio and video pages may occur out of order. Although these files
25       are usually playable, it can be difficult to accurately seek  or  scrub
26       on  them, increasing the likelihood of glitches during playback.  Play‐
27       ers may also need to use more memory in order to buffer the  audio  and
28       video  data  for synchronized playback, which can be a problem when the
29       files are viewed on low-memory devices.
30
31
32       Some older Ogg encoders also produce pages which incorrectly have gran‐
33       ulepos  timestamps recorded that shouldn't be: pages which have no com‐
34       pleted packets must have a granulepos of -1.   oggz-sort  will  correct
35       such granulepos during the process of sorting.
36
37
38       The  tool  oggz-validate  can be used to check the relative ordering of
39       packets in a file, and also to detect  incorrect  granulepos  on  pages
40       with  no  completed packets. If either of these errors are reported, or
41       use oggz-sort to fix the problem.
42
43

Options

45       oggz-sort accepts the following options:
46
47
48   Miscellaneous options
49       -o filename, --output filename
50                 Write output to the specified filename instead of printing it
51                 to standard output.
52
53
54       -h, --help
55                 Display usage information and exit.
56
57       -v, --version
58                 Output version information and exit.
59
60

EXAMPLES

62       Correct the page ordering in broken.ogv:
63
64              oggz sort -o fixed.ogv broken.ogv
65
66

AUTHOR

68       Conrad Parker        January 25, 2008;
69

71       Copyright © 2008 Annodex Association
72
73

SEE ALSO

75       oggz-validate(1), oggz-merge(1), oggz-dump(1), oggz-diff(1), hogg(1)
76
77
78
79                                                                  oggz-sort(1)
Impressum