oggz-sort(1)

✨ oggz-sort ✨

okay bestie, welcome to the General Commands Manual, this is oggz-sort(1) and she is literally the friend who shows up and puts your chaotic playlist in the right order 💅

---

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. She correctly interprets the granulepos timestamps of Ogg CELT, CMML, Dirac, FLAC, Kate, Opus, PCM, Speex, Theora, Vorbis and VP8 bitstreams. Wanna see the whole squad? 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. No shade to them but like... 😭 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. your poor little phone is fighting for its life fr fr

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. not her doing a little cleanup on the side, we love a multitasker ✨

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. very "save it, don't yap it at my terminal" energy
• -h, --help — Display usage information and exit. she's giving you the rundown, then she's gone
• -v, --version — Output version information and exit. who even am i? find out 💅

---

EXAMPLES 🌈

Correct the page ordering in broken.ogv:

oggz sort -o fixed.ogv broken.ogv

look at that glow-up, broken.ogv → fixed.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)

---

and that's the whole page bestie 🫶 this lil icon lives in the General Commands Manual, she's oggz-sort(1), and the vibe is straight outta January 25, 2008. mwah, go sort something 💅✨