OGGTRANSCODE(1)

✨ oggTranscode 💅 (that's the manual page name, bestie, section 1)

🌸 NAME 🌸

oggTranscode — the tool that transcodes your ogg files in so many different ways, it's giving Swiss Army knife energy 🎀

🦋 SYNOPSIS 🦋

oggTranscode [options] inputfile.ogv outputfile.ogv

💜 DESCRIPTION 💜

okay so. oggTranscode can resize an ogg file — and when we say ogg we mean ogg, oga or ogv, no gatekeeping here — in multiple ways. She can:

• change the video frame size 🖼️
• change the datarate for the video and/or audio streams inside that ogg file 🎚️
• change the video frame rate, or the audio sample rate 🔥

And then — since version 0.8, so she's been upgraded — oggTranscode can also add any ogg comment, and png-pictures with an alpha channel can be rendered right into the video at any time period, before and after the resizing process. iconic behaviour, honestly.

Also for the lore: oggTranscode was previously called oggResize. she rebranded. we respect it. 👑

🎀 OPTIONS 🎀

• -s — sets the size of the video frame, given as <width>x<height>. At default, the video frame size keeps the same. 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 end up smaller than you assumed. If not set, the datarate of the original stream 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 original stream 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 original video 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 of the original file, resamling is invoked. (yes bestie, she resamples, we love a glow-up) 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, because 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, because the command line may use the semicolon as a separator. 💖 Example: -C 'AUTHOR=yorn;DATE=03.07.09'
• -q — specifies the quality for the resizing process. Values can be chosen between 1 (best quality, with slight bluring) and 6 (worst quality). The default value is 2. Example: -q1
• -p — this option is meant to help creating a preview of a film. The number given with this option defines the number of frames that are omitted. E.g. if a film has 24 frames per second and -p24 is given, the newly created video shows the video 24 times faster, as only every 24th frame is used. This option can be combined with the option -f to control the framerate. With both options, nice video previews can be created. If -p is used, the audio stream is ignored. 😭 (sorry audio girlies) Example: -p 24
• -a — adds a picture to the video frame before it is resized. The expression for the picture appearances:

<picture1.png>[,<startTime>[,<endTime>[,s]]]

• startTime in seconds — value can be a floating point. Default startTime is 0
• endTime in seconds — value can be a floating point. Default endTime is -1, which is the end of the stream duration
• default s ist not set. If s is set, the picture slides in smoothly. 🧚

More than one picture can be included. To concatenate the expressions use the colon. If the appearance times overlap, the pictures are placed on one another, so the last picture is the uppest layer. (yes, layer order matters, she's stacking, she's collaging 💅)

Example: -a etwas.png,2,7,s:etwasneues.png,5,10

• -A — adds a picture to the video frame after it is resized. The syntax follows the same expression as with option -a. 🫶

🌈 EXAMPLE 🌈

oggTranscode -s320x240 -d512000 orig.ogv new.ogv

Converts the video orig.ogv to the video new.ogv with the new frame size 320x240. If there was an audio stream within the orig.ogv file, it is copied into the new file.

oggTranscode -D64000 -F16000 -N1 orig.ogv new.ogv

Converts only the audio stream of file orig.ogv to a sample rate of 16kHz, a datarate of 64 kBit/s and a mono channel. The video stream is copied as is.

oggTranscode -s300x200 -D32000 -d1024000 -A etwas.png,2,7,s:etwasneues.png,5,10 orig.ogv new.ogv

Converts the audio and video stream and adds the alpha channel picture etwas.png to the video from second 2 to second 7 with a smooth fade in and fade out. Additionally the alpha channel picture etwasneues.png is placed on top of the video frame from second 5 to second 10 without any fading. ✨

👑 AUTHOR 👑

Joern Seger <yorn at gmx dot net> — the original main character, we stan 🌟

💀 SEE ALSO 💀

oggCut(1), oggCat(1), oggJoin(1), oggSplit(1), oggSlideshow(1), oggThumb(1), oggSilence(1) — the whole friend group, go say hi 🫶

and that's the whole page, bestie, no cap 💖

okay so the fine print: this little doc lives on Linux, it's the JAN 2010 version, and it's the OGGTRANSCODE(1) manual page. slay, go transcode something. 🎀🦋⭐