OGGZ-RIP(1)

📦
version 1.1.3 · 3 versions
, in arch rolling, debian trixie, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 OGGZ-RIP 💖

okay bestie, welcome to the oggz-rip(1) page from the General Commands Manual (yes, section 1, we're in the big leagues) — and ngl, this little tool is lowkey iconic. it extracts logical bitstreams. it serves. periodt.

✨ NAME ✨

oggz-rip — Extract one or more logical bitstreams from an Ogg file. that's it, that's the whole job, and she does it beautifully. 🎀

🌸 SYNOPSIS 🌸

oggz-rip [-o filename | --output filename] filename

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

like, you either give her a file to rip, or you ask her a question. no in-between. 💅

🦋 DESCRIPTION 🦋

so here's the tea: oggz-rip extracts one or more tracks from an Ogg file. and in Ogg terminology — because of course there's terminology — oggz-rip extracts one or more logical bitstreams. same thing, cuter name. 💜

for example, to extract just the Vorbis audio track from any Ogg file:

oggz-rip -c vorbis input.ogx > output.ogg

and this will remove any other tracks: Skeleton, Theora, image, etc. etc. all of them, gone, not invited. 🙈 the output will be a valid Ogg Vorbis I file, suitable for use on hardware players that do not support multiplexed (ie. multi-track) Ogg files. so basically you're doing your old mp3-player-adjacent devices a solid. main character energy fr fr. 👑

and if the input file contains multiple bitstreams of the desired type, then they can be selected by serialno with the -s option. use oggz-info to view the serialno of each track in a file. it's giving detective work but make it Ogg. 🔍

💅 OPTIONS 💅

oggz-rip accepts the following options:

🍓 Miscellaneous options

  • -o, --output filename — Write output to the specified filename instead of printing it to standard output. no more > redirects if you don't want them, she'll just write the file herself. ✨
  • -h, --help — Display usage information and exit. she tells you how she works and then she dips. 💨
  • -v, --version — Output version information and exit. so you know exactly which queen you're talking to. 👑

🌈 Filter options

these options can be used multiple times. and here's the crucial part, bestie: pages matching ANY of the filter options will be included into the output. any. not all. ANY. write that down. 📝

  • -s, --serialno serialno — Output streams with given serialno. this is the one you pair with oggz-info when you've got several streams of the same type and need to pick your fave. 🫶
  • -i, --stream-index index — Filter by stream index. these are assigned to streams in the order of their BOS pages, starting at 0. so first BOS page = 0, next = 1, etc. counting from zero like a real one. 🔢
  • -c, --content-type content-type — Filter by content-type. run oggz-known-codecs(1) for a full list of codecs known by the installed version of oggz. don't guess the codec name, just check the list, i'm begging. 😭

🔥 EXAMPLES 🔥

extract all bitstreams from file.ogg:

oggz rip -o output.ogg file.ogg

extract only the Theora bitstream from file.ogv:

oggz rip -c theora -o output.ogv file.ogv

see how clean that is?? she ate and left no crumbs. 🎀

👑 AUTHOR 👑

David Kuehling January 1, 2005;

shoutout to David, dropping this in 2005 and it's still slaying. 🫡

Copyright © 2005 CSIRO Australia

🌟 SEE ALSO 🌟

oggz-merge(1), oggz-chop(1), oggz-dump(1), oggz-diff(1), hogg(1)

the whole squad, the whole friend group, go say hi to all of them. 💜

and that's a wrap!! this page is from May 3, 2013, and it lives in the OGGZ-RIP(1) corner of your manual pages. ty for coming to my ted talk, now go rip some bitstreams responsibly. mwah. 💋✨🦋

📦 where this page comes from