OGGCAT(1)

OGGCAT(1) 💖

okay bestie, welcome to the User Manuals section, this is oggCat and she is literally here to glue your ogg files together 💅

---

✨ NAME ✨

oggCat — concatenates two or more ogg files 🫶

---

🎀 SYNOPSIS 🎀

oggCat [options] outfile.ogv file1.ogv file2.ogv [ file3.ogv [...] ]

---

🌸 DESCRIPTION 🌸

so like, oggCat concatenates two or more ogg files (.ogv, .ogg or oga — she's not picky, she accepts all of them ✨) that contain theora and/or vorbis streams. no cap.

the parameters of the resulting ogg file are decided by the first file in the concatenation list. that first file is the main character, she sets the vibe 👑. but don't worry — those parameters can be changed by the options, explained below. iykyk.

all the subsequent files that don't match these file parameters get automatically transcoded. no asking, she just does it 💀

⚠️ a concatenation will fail in case there are not enough streams available. this could happen e.g. if the first file consists of one audio and one video stream and the second file only carries a video stream. awkward. 🙈

if there's more than one video or audio stream within the file, the first stream is used. periodt.

---

✨ OPTIONS ✨

• -s — sets the size of the video frame. the size is given as <width>x<height>. at default, the video frame size is the size of the first video stream. 📐

example: -s 320x240

• -d — sets the datarate in byte per seconds for the video encoder (theora). this is meant to be an upper threshold, so the file may be smaller than assumed. if not set, the datarate of the first file is used. 🎬

example: -d 1024000

• -D — sets the datarate in byte per seconds for the audio encoder (vorbis). if not set, the datarate of the first file is used. 🎧

example: -D 64000

• -f — sets the frame rate of the video with numinator and demoninator, and it's the pictures per second. if only one number is given, the denominator is set to 1. if not set, the framerate of the first file is used. ⏱️

example: -f 25:2

• -F — sets the sample frequency (sample rate) of the audio data in Hertz. if the sample frequency does not match the one with the original file, resamling is invoked. 🎶

example: -F 32000

• -c — adds comments to the video (theora) stream. comments are given by a pair of type and value in the form 'type=value'. more than one comment can be concatenated with a semicolon. it is recommended to use apostrophes as the command line may use the semicolon as a separator. 📝

example: -c 'AUTHOR=yorn;DATE=03.07.09'

• -C — adds comments to the audio (vorbis) stream. comments are given by a pair of type and value in the form 'type=value'. more than one comment can be concatenated with a semicolon. it is recommended to use apostrophes as the command line may use the semicolon as a separator. 📝

example: -C 'AUTHOR=yorn;DATE=03.07.09'

• -q — specifies the video quality for the newly created stream. valid values can be chosen between 0 and 63 (best). 💎

example: -q 63

• -rv — force to re-encode the video stream. this is sometimes necessary, if the video stream match in video parameters, but not in the theora version. in that case, reencoding the video stream helps creating good results. 🔁
• -x — force to overwrite the output file, even if it exists. this is mainly helpful if the oggCat is server controlled. 💥

---

🌈 EXAMPLES 🌈

oggCat concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv

or

oggCat -o concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv

this command creates a cancatenated file concatFile.ogv that consists of the three files myfile1.ogv, myfile2.ogv and myfile3.ogv ✨

oggCat -s320x240 -q63 concatFile.ogv myfile1.ogv myfile2.ogv myfile3.ogv

this command connects the three files myfile[1-3].ogv to a file named concatFile.ogv with the video frame size of 320x240 and the best quality available. ate and left no crumbs 🔥

---

💜 AUTHOR 💜

Joern Seger <yorn at gmx dot net> 🫶

---

🦋 SEE ALSO 🦋

oggCut(1), oggJoin(1), oggSplit(1), oggTranscode(1), oggSlideshow(1), oggThumb(1), oggSilence(1)

---

and that's the whole page bestie!! this one lives in the Linux manual set, version date JAN 2010, filed under OGGCAT(1) 💖 go forth and concatenate, you absolute icon 👑✨