dir2slideshow(1)

💖 dir2slideshow — like, the manual but make it make sense ✨

okay bestie, so this is dir2slideshow(1), and it lives in the dvd-slideshow family of tools. no cap, it's the little helper that turns a folder full of pics into an input file that dvd-slideshow can actually eat. let's get into it 🫶

🌸 NAME 🌸

dir2slideshow — creates an input file for dvd-slideshow from pictures in a directory.

🎀 SYNOPSIS 🎀

dir2slideshow [-o <output directory>] [-t <Seconds per picture>] [-c
<Crossfade seconds>] -n <Slideshow name> [-T] [-M] [-s subtitle_text]
[-notitle] <Images directory>

✨ DESCRIPTION ✨

So basically: it creates an input file for dvd-slideshow out of all the JPEG images sitting in whatever directory you point it at. and now — glow up moment — it also reads all .jpg, .JPG, .jpeg, .png and .PNG files in that directory. periodt. 💅

👑 OPTIONS 👑

• <Images directory> — the path to the directory holding the images you wanna use. this one's the whole point, don't forget it.
• -n <Slideshow name> — the name of this slideshow. it gets used as the default title text for the first title slide, and it's also what the output file gets named. so like, name it something cute.
• [-t <Seconds per picture>] — how many seconds each picture stays on screen in the movie. if you don't say anything, it defaults to 5 seconds.
• [-o <Output directory>] — the directory where the output file gets written. if you skip it, it just chills in the current directory. lowkey convenient.
• [-c <Crossfade seconds>] — how many seconds to crossfade between images. one second is usually fine. heads up tho: this makes processing take longer, but it looks nice. worth it. 🦋
• [-w <Wipe seconds>] — how many seconds to wipe between images. one second is usually fine. pick either crossfade or wipe, bestie, not both.
• [-T] — sorts the images by the JPEG header picture-taken time, then by file modification date, and finally by filename. the default sort is by name only. requires the jhead program, fyi.
• [-M] — sorts images by file modification date, and then by filename. again, the default sort is by name only.
• [-s subtitle_text] — adds the default subtitle "subtitle_text" to every single slide. use -s filename to display the filename as the subtitle. use -s path to display the path and filename as the subtitle. options on options ✨
• [-s2 subtitle_text] — same as -s, but it drops the subtitles onto subtitle track 2 instead.
• [-b background.jpg] — uses background.jpg as the background image. default is just plain black. iconic but simple.
• [-notitle] — do not create a title slide. skipping the intro, bold move.
• [-r] — recursively searches directories for images, creating one output file. go deep, bestie.
• [-k] — applies random kenburns effects to the images. > ngl, use of this is discouraged because encoding takes sooooo long. 😭
• [-p] — use PAL output video format instead of NTSC.
• [-theme themename] — use themename as a theme file. see the theme help files for more info. (TBD)
• [-a audiofile1,audiofile2,...] — adds audio files to the slideshow. the files play sequentially for the duration of the slideshow. use quotes if you've got spaces in filenames, bestie. 🎧
• [-q] — quiet mode: outputs less screen output. for when the terminal is doing too much.

🌈 EXAMPLES 🌈

fr fr, the examples live here:

http://dvd-slideshow.sourceforge.net

💜 AUTHORS 💜

• Scott Dylewski <scott at dylewski dot com>
• http://dvd-slideshow.sourceforge.net/

🧚 SEE ALSO 🧚

dvd-menu(1), dvd-slideshow(1)

okay that's the whole page bestie, you ate 🍓 this was written by Scott Dylewski, version 0.8.4, and it's part of the dir2slideshow(1) manual. go make something gorgeous 💖✨🎀