iconvert(1)

📦
version 3.1.18.1 · 13 versions
, in fedora 44

✨ NAME ✨

iconvert — copy images with format conversions and other alterations

okay so this is iconvert(1), a lil icon from the OpenImageIO fam 💖 she copies your images and flips them into whatever format you're feeling that day.

🦋 SYNOPSIS 🦋

Usage:  iconvert [options] inputfile outputfile
 or:  iconvert [options] inputfile -o outputfile
 or:  iconvert --inplace [options] file...

three whole moods. pick your fighter 🫶

💖 DESCRIPTION 💖

This program is part of the OpenImageIO (http://www.openimageio.org) tool suite. Detailed documentation is available in pdf format with the OpenImageIO distribution.

bestie that's the whole vibe. it's an OIIO tool, it lives with the other OIIO tools, and if you want the full deep dive there's a whole pdf in the OpenImageIO distribution waiting for you like a little reading assignment. no cap, go read it if you want the lore 📚✨

%*

(yes, this really is in there. mysterious. iconic. we don't question it. 💅)

👑 OPTIONS 👑

every single one, in order, no skips, no skimming, we're doing the whole thing 🎀

  • --help — Print help message. she'll explain herself ✨
  • -v — Verbose status messages. she'll narrate her life to you, main character energy 💬
  • -o FILENAME — Output filename. tell her where the glow-up goes 📁
  • --threads NTHREADS — Number of threads (default 0 = #cores). default is literally "use all your cores," she's hungry 🔥
  • -d TYPE — Set the output data format to one of: uint8, sint8, uint10, uint12, uint16, sint16, half, float, double. pick your pixel personality 💫
  • -g GAMMA — Set gamma correction (default = 1.0) 🌈
  • --tile WIDTH HEIGHT — Output as a tiled image. little squares, very aesthetic 🧩
  • --scanline — Output as a scanline image. rows on rows on rows ➡️
  • --compression METHOD — Set the compression method (default = same as input). Note: may be in the form "name:quality" --quality %d 🤐
  • --no-copy-image — Do not use ImageOutput copy_image functionality (dbg) 🐛
  • --adjust-time — Adjust file times to match DateTime metadata. she's syncing her calendar fr fr 🕰️
  • --caption TEXT — Set caption (ImageDescription) 🏷️
  • --keyword NAME — Add a keyword 🔖
  • --clear-keywords — Clear keywords. all of them. gone. poof 💨
  • --attrib NAME VALUE — Set a string attribute 📝
  • --orientation ORIENT — Set the orientation 🧭
  • --rotcw — Rotate 90 deg clockwise. spin that pic 🔄
  • --rotccw — Rotate 90 deg counter-clockwise. other direction, still slaying 🔃
  • --rot180 — Rotate 180 deg. full flip, no notes 🙃
  • --inplace — Do operations in place on images. careful bestie, she's editing the original ✂️
  • --sRGB — This file is in sRGB color space 🎨
  • --separate — Force planarconfig separate 🪞
  • --contig — Force planarconfig contig 🧵
  • --no-clobber — Do not overwrite existing files. she will NOT be stepping on your existing files, boundaries are healthy 🛑
heads up bestie: --inplace does operations in place on your images, so it's touching the originals — and --no-clobber exists specifically so nothing gets overwritten when you don't want it to be. know before you run, iykyk 💀

that's the whole page, you ate it, you understood it, you're literally an OIIO girlie now 🦋

OpenImageIO · iconvert(1) · 05 October 2026 — mwah, ily, go convert something pretty 💅🌸

📦 where this page comes from