oggz-dump(1)

💅 oggz-dump — the manual page, but make it make sense

okay bestie, welcome to the oggz-dump(1) page from the General Commands Manual ✨ this is the little tool that hexdumps the packets inside an Ogg file, or goes the other way and rebuilds an Ogg file back out of one of those hexdumps. it's giving time-travel but for bytes 🦋

🌸 NAME 🌸

oggz-dump — hexdump packets of an Ogg file, or revert an Ogg file from such a hexdump 💖

✨ SYNOPSIS ✨

like, here's how you call it:

oggz-dump [-b  | --binary ]  [-x  | --hexadecimal ]  [-n  | --new ]  [-o
filename  | --output filename ]  [-c content-type  | --content-type
content-type ]  [-s serialno  | --serialno serialno ]  [-O  | --hide-
offset ]  [-S  | --hide-serialno ]  [-G  | --hide-granulepos ]  [-P  |
--hide-packetno ] filename

oggz-dump [-r  | --revert ]  [-o filename  | --output filename ]
filename

oggz-dump [-h  | --help ]  [-v  | --version ]

three whole moods, pick your fighter 👑

🫶 Description 🫶

so oggz-dump either generates a hexadecimal or binary dump of the packets in an Ogg file, or it does the reverse and creates an Ogg file from a hexadecimal oggz-dump file. yes, it's bidirectional, it's versatile, it's the moment 💅

🎀 Options 🎀

oggz-dump accepts the following options, and there are a lot of them, so buckle up:

🍓 Dump format options

• -b, --binary — generate a binary dump of each packet. raw bytes, no notes 🧚
• -x, --hexadecimal — generate a hexadecimal dump of each packet. classic hex girlie behaviour ✨

🌈 Filtering options

• -n, --new — only dump the first packet of each new logical bitstream it finds. for correctly formed Ogg files that means you only get the beginning-of-stream packets. like, first impressions only 💖
• -c content-type, --content-type content-type — dump only the logical bitstreams for one specific content-type. run oggz-known-codecs(1) for the full list of codecs known by the version of oggz you actually have installed 👑
• -s serialno, --serialno serialno — dump only the logical bitstream with the specified serialno. one bitstream, one bestie, no distractions 🌸
• -O, --hide-offset — hide the byte offset field of the preamble for each packet dumped. lowkey iconic when you're using it with oggzdiff(1) to compare Ogg bitstreams that differ only in page structure 🙈
• -S, --hide-serialno — hide the serialno field of the preamble for each packet dumped. same energy: super useful alongside oggzdiff(1) when comparing Ogg bitstreams that differ only in serialno assignment 💅
• -G, --hide-granulepos — hide the granulepos field of the preamble for each packet dumped. bye felicia 🦋
• -P, --hide-packetno — hide the packetno field of the preamble for each packet dumped. gone, not sorry ⭐

🧚 Mode options

• -r, --revert — revert an oggz-dump. it generates an Ogg bitstream as prescribed in the input oggz-dump.

the serialno, granulepos and packetno fields of the packet preambles in the oggz-dump, plus any bos or eos markers if they're present, get used to structure the packets into logical bitstreams. so yeah — it is advised that the original input oggz-dump not be generated with any hiding filters. no cap, hiding stuff will ruin the rebuild 😭

only the hexadecimal data columns of the input oggz-dump are parsed when generating Ogg packet data. the printable character representation? ignored. not invited. 💀

💜 Miscellaneous options

• -o filename, --output filename — write output to the specified filename instead of printing it to standard output. file girlies rise 🎀
• -h, --help — display usage information and exit. the classic cry for help 🫶
• -v, --version — output version information and exit. tell me who you are ✨

🔥 EXAMPLES 🔥

dump all the bitstreams in file.ogg:

oggz dump file.ogg

dump only the Theora bitstream in file.ogv:

oggz dump -c theora file.ogv

see how it's oggz dump in the examples? that's not a typo on my part, that's literally what's written, don't come for me 💖

👑 AUTHOR 👑

Conrad Parker — November 17, 2003;

🌈 COPYRIGHT 🌈

Copyright © 2003 CSIRO Australia

⭐ SEE ALSO ⭐

oggz-diff(1), hogg(1), xxd(1), hexdump(1)

and that's the whole page bestie, we ate and left no crumbs 💅 this was oggz-dump(1), from the General Commands Manual — that exact title, dated and versioned and everything, is the little footer this page wears like a tiny crown 👑 go hexdump something, ily 🦋✨