OGGSLIDESHOW(1)

💖 OGGSLIDESHOW 💖

okay bestie, so oggSlideshow is a lil tool from the User Manuals corner of the internet (you know, the (1) crew) and it's genuinely iconic — it takes your pictures and turns them into a whole slideshow video. Let's get into it 🎀

---

✨ NAME ✨

oggSlideshow — creates slideshows from pictures 🖼️➡️🎬

---

🌸 SYNOPSIS 🌸

oggSlideshow [options] picture1 [ picture2 [...] ]

like. you give it pictures. it gives you a video. that's the whole vibe fr fr 💅

---

🦋 DESCRIPTION 🦋

So oggSlideshow creates a theora video out of a bunch of pictures, in JPEG or PNG format, and it slaps different visual effects on top. That's it, that's the gig. It's giving "art project but make it automated" ✨

---

👑 OPTIONS 👑

• -s — sets the size of the video frame. You write it as <width>x<height>. The default is 480x320.

Example: -s 320x240

• -f — sets the frame rate of the video, given in pictures per second. Default is 24 pictures per second.

Example: -f 16

• -o — sets the output file name of the created video. Default is slideshow.ogv.

Example: -o myShow.ogv

• -l — sets the presentation time (length) of one picture. So if you have 10 pictures and you specify a length of 10 seconds, your overall video length is 1:40 (100 seconds). Math ate, honestly 🧮✨

Example: -l 10

• -d — sets the datarate in byte per seconds for the video encoder. It's more of an upper threshold kinda situation, so the file may come out smaller than you assumed.

Example: -d 1024000

• -t — sets the presentation type (the types are listed right here, iykyk). The actual types are:
  • kb — Ken Burns effect (default) 🎥
  • cf — picture crossfade for changeover 🌈
  • p — plain picture presentation 🖼️
  • bl — bluring at changeover 💫

Example: -t p

• -e — enables the reframing. If a picture doesn't match the aspect ratio of the video frame, it can be "reframed", which means black borders are inserted. Heads up bestie: this option is only useful with the Ken Burns effect (option -t kb). With the other two slideshow types the pictures are automatically "reframed" to match the aspect ratio, so you don't gotta do anything 🫶

Example: -e

• -x — overwrite an existing output file without warning. No "are you sure?" moment, it just goes 💀
• -r — enables the resampling to a certain value. Real talk: this is really only for experts and may not be available with newer version of oggSlideshow. So if you're on a newer build, don't come for me if it ghosts you 🙈

To actually understand this option you need some more internal tea: the picture is loaded by the gd lib, so the transformation from png or jpeg to a plain RGBA is done here. The second reason for using gd is the great resizing facilities, because pictures are often much bigger than the video frame. OggSlideshow can handle pictures from 0.5 to 2 times of the video frame width and height best, since it uses a linear pixel interpolation. With the resizing feature of gd, oggSlideshow reads pictures with a size "near" to the video output size and can then operate with that picture. This produces a very good quality output, as you can see above ✨

The value you give with this option is the factor the picture is read in in respect of the video frame size. When the video frame size is 320x240 and the resample factor is 1.2, then the picture that is read is resized to 384x288. Specially for the ken burns effect this is important, since the sliding is done on a picture bigger than the video frame size 👑

---

🌈 EXAMPLE 🌈

oggSlideshow -l3 -tp -d1024000 -s480x320 -o demo-plain.ogv
<picture1.jpg> <picture2.jpg> ...

look at her go 😭💖

---

💜 AUTHOR 💜

Joern Seger <yorn at gmx dot net> — shoutout to the dev, we love a legend 🫶

---

⭐ SEE ALSO ⭐

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

the whole ogg family, we stan a supportive friend group 👑

---

and that's the page, bestie 🎀 this one's a Linux situation, dated JAN 2010 — yeah she's an elder but she ate and left no crumbs, periodt 💅✨