oggz-merge(1)

💖 oggz-merge — the manual page, bestie edition 💖

okay so real talk, this is oggz-merge(1), one of the General Commands Manual girlies, and she is iconic. let's get into it ✨

---

🌈 NAME 🌈

oggz-merge — Merge Ogg files together, interleaving pages in order of presentation time. 🎀

---

✨ SYNOPSIS ✨

oggz-merge [-o filename  | --output filename ] filename ...

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

---

🦋 Description 🦋

so oggz-merge merges Ogg files together, interleaving pages in order of presentation time. like, it takes your little Ogg babies and weaves them into one big slay. and it correctly interprets the granulepos timestamps of Ogg CELT, CMML, Dirac, FLAC, Kate, Opus, PCM, Speex, Theora, Vorbis and VP8 bitstreams. 💅

ngl if you wanna see the full list of codecs that your installed version of oggz knows about, just run oggz-known-codecs(1). she'll tell you everything. 👑

for example, say you have an Ogg Theora video file, and its soundtrack is chilling separately as an Ogg Speex audio file — you can use oggz-merge to create a single Ogg file with the video and audio, interleaved together in parallel. main character energy fr fr. 🎬🎵

similarly, using oggz-merge on a collection of Ogg Vorbis audio files will create one big Ogg file with all the songs in parallel, ie. interleaved for simultaneous playback. such a file is proper Ogg, but not "Ogg Vorbis I" — because the Ogg Vorbis I specification defines an Ogg Vorbis file as an Ogg file containing only one Vorbis track at a time (ie. no parallel multiplexing). 😭 Many music players (which use libvorbisfile) aren't designed to play multitrack Ogg files. In general however, video players, and anything built on a multimedia framework (like GStreamer, DirectShow etc.) will probably be able to handle such files. so like, know your audience bestie 🫶

and if what you actually want is a file containing some Ogg files sequenced one after another — not merged, just stacked — then you should simply concatenate them together using cat. In Ogg this is called "chaining". and here's the cute part: if you cat Ogg Vorbis I audio files together, then the result will also be a compliant Ogg Vorbis file. 💖

---

💅 Options 💅

oggz-merge accepts the following options:

🌸 Miscellaneous options 🌸

• -o filename, --output filename — Write output to the specified filename instead of printing it to standard output. like, give it a home instead of yeeting it at stdout 💌
• -h, --help — Display usage information and exit. quick little "how do i even" moment 🥺
• -v, --version — Output version information and exit. she tells you her age, periodt 💀

---

🔥 EXAMPLES 🔥

Merge pages of audio.oga and video.ogv:

oggz merge -o output.ogv audio.oga video.ogv

(yeah it's written as oggz merge up there in the example, no hyphen, that's just how it is, we don't question the ancestors 🙈)

---

👑 AUTHOR 👑

Conrad Parker September 21, 2004;

---

🎀 COPYRIGHT 🎀

Copyright © 2004 CSIRO Australia

---

🌟 SEE ALSO 🌟

cat(1), oggz-rip(1), oggz-dump(1), oggz-diff(1), hogg(1)

---

okay that's the whole page, we ate and left no crumbs 🍓✨ this was oggz-merge(1) from the General Commands Manual, dated back to September 21, 2004 — shoutout to the vintage queen for still serving us granulepos realness. mwah, love u, go merge something 💜🦋🌸