OGMINFO(1)

💖 OGMINFO(1) 💖

okay bestie, pull up a chair, we're reading the manual page for ogminfo — a User Command, section 1, and honestly? it's giving ✨detective energy✨ for your media files.

🌸 NAME 🌸

ogminfo — print information about streams in OGG/OGM files 🎀

🦋 SYNOPSIS 🦋

ogminfo [options] inname

✨ DESCRIPTION ✨

So like, this program lists all the streams chillin' inside an OGM, plus all the juicy deets about which codecs they're using. no cap, it just tells you everything 💅

• inname — use inname as the source. that's your input file, bestie, the whole point 🫶
• -v, --verbose — be verbose and show each OGG packet. the way it does this is fully explained down in the VERBOSITY LEVELS section, so don't skip it 👑
• -s, --summary — prints a short summary for each stream: total size in bytes, the bitrate, the number of packets/frames, and the length in seconds. heads up tho — this requires parsing the complete file, so it's not a quick peek, it's the whole read-through 📖
• -h, --help — show usage information. the classic.
• -V, --version — show version information. also the classic.

🌈 VERBOSITY LEVELS 🌈

the -v option bumps up ogminfo's verbosity level so it spills more tea about the file you're looking at. here's the whole ladder:

• level 0 — will print only the streams it finds and their types. lowkey minimal, highkey useful.
• level 1 — will also print each stream's header and comment packets' contents. and here's the cute part: these two modes will not process the whole file (as opposed to all other modes) if the comment packets are placed correctly. so if everything's where it should be, it just peaces out early 😌
• level 2 — will print a line for each OGG packet it encounters, containing the stream the packet belongs to, the payload size, the packet's granulepos, the packet's number, its start time, its end time, and several flags. the flags may include sync_ok or OUT_OF_SYNC, which indicates whether the packet's placement in the file is correct according to its granulepos. other flags are IS_SYNCPOINT or EOS.

also, level 2 and above automatically imply --summary. surprise! you asked for more, you get more 💀

• level 3 — also prints a line whenever a new OGG page was read completely, along with the page's exact position in the file it was read from. very "receipts" of it 🔥
• level 4 — will dump the complete stream_header structure found in the header packet for any non-Vorbis stream. full unhinged data dump, we love to see it 🧚

⚠️ the levels 3 and 4 are intended for debugging purposes only. they're not for casual scrolling, bestie.

🍓 NOTES 🍓

what works: 👑

• OGM with Vorbis audio
• 'normal' video (like DivX etc.)
• audio streams (PCM, MP3 etc.)
• text streams (subtitles)

what not works: 😭

• Headers created by older OggDS (DirectShow) filter versions are not supported (and probably never will be). it's giving "we've moved on" energy, fr fr.

💜 AUTHOR 💜

ogminfo was written by Moritz Bunkus <moritz@bunkus.org>. icon behavior, honestly 🫶

👑 SEE ALSO 👑

ogmmerge(1), ogmsplit(1), ogmdemux(1), ogmcat(1), dvdxchap(1) — go read the whole friend group, they're all slay.

🌐 WWW 🌐

the newest version can always be found at <http://www.bunkus.org/videotools/ogmtools/>

and that's the whole page, bestie 💖 this was ogminfo v1.5, dated November 2004 — yeah, she's vintage, and she ATE. periodt. 🌸✨