VIPSTHUMBNAIL(1)

💖 VIPSTHUMBNAIL(1) 💖

okay so bestie, welcome to the General Commands Manual glow-up of vipsthumbnail — she makes thumbnails of image files and she is, frankly, iconic 💅

---

✨ NAME ✨

vipsthumbnail — make thumbnails of image files 🎀

---

🌸 SYNOPSIS 🌸

vipsthumbnail [flags] imagefile1 imagefile2 ...

---

🦋 DESCRIPTION 🦋

vipsthumbnail(1) goes through every imagefile one at a time, like a lil assembly line of slay ✨. Each image gets shrunk down so it fits inside a 128 by 128 pixel square, and then that shrunk lil baby gets written out to a brand new file named tn_imagefile.jpg. No cap, this program is typically faster and uses less memory than those other image thumbnail programs. main character energy fr fr 👑

For example:

$ vipsthumbnail fred.png jim.tif

will read the image files fred.png and jim.tif, and write thumbnails out to the files tn_fred.jpg and tn_jim.jpg. two for two, we ate 🔥

$ vipsthumbnail --size=64 -o thumbnails/%s.png fred.jpg

will read the image file fred.jpg and write a 64 x 64 pixel thumbnail to the file thumbnails/fred.png. obsessed 🫶

---

💅 OPTIONS 💅

• -s N, --size=N — set the output thumbnail size to N x N pixels. 🌈

You can use "MxN" to specify a rectangular bounding box. The image is shrunk so that it just fits within this area — and plot twist, images which are smaller than this get expanded 😭.

Use "xN" or "Mx" to just resize on one axis. one-axis girlies rise 🙈

Append "<" to only resize if the input image is smaller than the target, and append ">" to only resize if the input image is larger than the target.

• --path=FORMAT — set the output path format. Three substitutions get performed, like lil magic tricks ✨: %s is replaced by the input basename with any suffix removed, %d is replaced by the input dirname, and %c is replaced by the current working directory.

The default value is %d/tn_%s.jpg, meaning JPEG output, to the same directory as the input file, with tn_ prepended. You can add format options too — for example %c/%s/tn_%s.jpg[Q=20] will write JPEG images to a tree within the current directory with Q set to 20. it's giving organized 🎀

• -e PROFILE, --eprofile=PROFILE — export thumbnails with this ICC profile. Images are only colour-transformed if there is both an output and an input profile available. The input profile can either be embedded in the input image, or supplied with the --iprofile option. 💜
• -i PROFILE, --iprofile=PROFILE — import images with this ICC profile, if no profile is embedded in the image. Images are only colour-transformed if there is both an output and an input profile available. The output profile should be supplied with the --oprofile option. 🌸
• -c, --crop — crop the output image down. The image is shrunk so as to completely fill the bounding box in both axes, then any excess gets cropped off. bye bye extra pixels 💀✂️
• -d, --delete — delete the output profile from the image. This can save a small amount of space. tiny file, big vibes 🍓
• -t, --rotate — auto-rotate images using EXIF orientation tags. she knows which way is up, periodt 🧚
• -a, --linear — shrink images in linear light colour space. This can be much slower, so maybe go grab a snack while she cooks 😭

---

⭐ RETURN VALUE ⭐

returns 0 on success and non-zero on error. Error can mean one or more conversions failed. 💔

---

👑 SEE ALSO 👑

vipsheader(1)

---

lowkey important: that return value thing is real — non-zero means something flopped, so check it if you're scripting bestie 🫶

and that's the whole page, no notes. this one's from the General Commands Manual, dated 13 May 2010 — vintage but still serving, and yes she is still that girl 💖✨🎀🦋