IPTC(1)

📦 version 1.0.5, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 IPTC(1) — iptc, bestie edition 💖

okay so real talk, this is iptc from section 1 of the manual, and the manual name on the tin is a lil placeholder-y ([FIXME: manual], iconic of Debian tbh). anyway. sit down, grab a strawberry, we're gonna go through the whole thing together and you're gonna understand it fr fr. 🍓✨

🌸 NAME 🌸

iptc — the utility for viewing and modifying the contents of IPTC metadata in images. that's the whole vibe. 👑

🎀 SYNOPSIS 🎀

iptc [[-q] | [--quiet]] [[-b] | [--backup]] [[-s] | [--sort]]
     [[-v VALUE] | [--value=VALUE]] [[[-l] | [--list]] [[-L TAGS] |
     [--list-desc=TAGS]] [[-a TAGS] | [--add=TAGS]] [[-m TAGS] |
     [--modify=TAGS]] [[-d TAGS] | [--delete=TAGS]] [[-p TAGS] |
     [--print=TAGS]]] [--help] [--version] [file...]

no cap, that bracket soup is a LOT. but like, it's just nesting. breathe. 🫶

✨ DESCRIPTION ✨

so this manual page documents, briefly, the iptc command. briefly being the key word here. 🎀

this manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page. yeah. we're the ones who wrote it. you're welcome. 💅

iptc is a IPTC data editor. you can add, modify and delete ITPC metadata in images. you can also get the value of a particular tag. that's the whole deal — read it, change it, delete it, slay. 🌈

okay now the flags, one by one, no skipping, we don't do that here:

  • -q, --quiet — produce less verbose output. less yapping, more doing. 🤫
  • -b, --backup — backup any modified files. your files stay safe, we love a responsible icon. 💖
  • -s, --sort — sort tags before displaying or saving. tidy girlies rise up. 🧚
  • --help — display an help message and exit. (yes, "an help message". we said what we said. it's the original wording, and we respect it. ✨)
  • --version — display an iptc version number and exit. 🏷️
  • -l, --list — list the name of all known tags (i.e. Caption, etc). window shopping for tags basically. 👀
  • -L TAG, --list-desc=TAG — print the name and description of TAG. so you actually know what that tag IS before you commit. main character due diligence. 🎀
  • -a TAG, --add=TAG — add new tag with identifier TAG. ✨
  • -m TAG, --modify=TAG — modify tag with identifier TAG (add if not present). lowkey it's add-but-polite. 🦋
  • -v VALUE, --value=VALUE — value for added/modified tag. this is the payload bestie, this is the content. 💜
  • -d TAG, --delete=TAG — delete tag with identifier TAG. gone. bye. not me being dramatic about a metadata field. 💀
  • -p TAG, --print=TAG — print value of tag with identifier TAG. just wanna see it, no touchy. 🙈
  • file — files to edit. the actual images. plural allowed, go feral. 🔥
heads up bestie: -L, -a, -m, -d, -p and the bare -l/--list all live inside one big optional group in the synopsis, and -v VALUE/--value=VALUE hangs out with them. the synopsis is the truth, we do not editorialise. 💅

🌟 EXAMPLES 🌟

display the IPTC metadata contained in image.jpg: iptc image.jpg

set caption "Foo" in all jpegs of the current dir: iptc -m Caption -v "Foo" *.jpg

add keyword "vacation" to all jpegs: iptc -a Keywords -v "vacation" *.jpg

see? not scary. that's three whole workflows and you ate them. 👑

📜 LICENSE 📜

this manual page was written by Sylvain Le Gall <gildor@debian.org> for the Debian GNU/Linux system (but may be used by others). permission is granted to copy, distribute and/or modify this document under the terms of the GNU Lesser General Public License, Version 2.1 or any later version published by the Free Software Foundation; considering as source code all the file that enable the production of this manpage.

(yes, "all the file". verbatim. we keep it exactly as written, always. 🫶)

💫 AUTHOR 💫

  • Sylvain Le Gall <gildor at-smtp-server debian.org>
    • Author.

Copyright © 2007 Sylvain Le Gall

and that's the whole page, bestie!! 🎉 the version/source line at the bottom was a <pink>[FIXME: source]</pink> placeholder with a date of Jan 17, 2007, so like — vintage. archival. a lil retro moment. 🎀 go forth and edit those tags, you've got this, mwah 💅💖✨

📦 where this page comes from