1oggz-sort(1) General Commands Manual oggz-sort(1)
2
3
4
6 oggz-sort — Sort the pages of an Ogg file in order of presentation
7 time.
8
9
11 oggz-sort [-o filename | --output filename ] filename
12
13 oggz-sort [-h | --help ] [-v | --version ]
14
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
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
62 Correct the page ordering in broken.ogv:
63
64 oggz sort -o fixed.ogv broken.ogv
65
66
68 Conrad Parker January 25, 2008;
69
71 Copyright © 2008 Annodex Association
72
73
75 oggz-validate(1), oggz-merge(1), oggz-dump(1), oggz-diff(1), hogg(1)
76
77
78
79 oggz-sort(1)