gtk4-image-tool(1)

💖 gtk4-image-tool — the Image Utility bestie 💖

okay so real talk: this is the GTK commands corner of your terminal, and gtk4-image-tool is literally your little image-handling bestie. she does stuff to images. a lot of stuff. let's get into it 🫶

---

✨ SYNOPSIS ✨

gtk4-image-tool <COMMAND> [OPTIONS...] <FILE>...

gtk4-image-tool compare [OPTIONS...] <FILE1> <FILE2>
gtk4-image-tool convert [OPTIONS...] <FILE1> <FILE2>
gtk4-image-tool info [OPTIONS...] <FILE>
gtk4-image-tool relabel [OPTIONS...] <FILE1> <FILE2>
gtk4-image-tool show [OPTIONS...] <FILE>...
gtk4-image-tool play [OPTIONS...] <FILE>...

---

🌸 DESCRIPTION 🌸

gtk4-image-tool can perform various operations on images. that's the whole vibe. multiple operations. on images. she's versatile like that 💅

---

👑 COMMANDS 👑

🔍 Information

the info command shows general information about the image, such as its format and color state. it's giving "tell me everything about yourself, no filter" 💖

🖼️ Showing

the show command displays one or more images, side-by-side. girlies lined up in a row, iconic.

• --undecorated — Removes window decorations. This is meant for rendering of exactly the image without any titlebar. no chrome, no titlebar, just pure image main character energy ✨

🎬 Playing

the play command plays one or more SVG animations, side-by-side. Clicking on the animation will change the state of the GtkSvg paintable, where applicable. yes bestie, you can click on them and they react. interactive fr fr 🦋

• --undecorated — Removes window decorations. This is meant for rendering of exactly the animation without any titlebar. again, no titlebar, just vibes.
• --size=SIZE — Show the animation at the given size. pick your size, queen.
• --no-animations — Disable animation playback. sometimes we need stillness, periodt.
• --no-system-resources — Disable the use of system fonts. Embedded fonts will still be used. so the fonts baked into the file? still there. the system ones? not invited.
• --no-external-resources — Disable loading of external resources such as images. Embedded images and images that included as resources in the application are still used.
• --no-extensions — Disable gpa extensions, such as states, transitions and dynamic stroke weight. turning off the fancy extras, lowkey a simpler era.

⚖️ Compare

the compare command compares two images. If any differences are found, the exit code is 1. If the images are identical, it is 0. so the exit code is literally telling you "same" or "not same" — vibe check in number form 💀

• --output=FILE — Save the differences as a png image in FILE. so you can literally see what's different. receipts.
• --quiet — Don't write results to stdout. shhh. silent mode. no commentary, just answers 🙈

🎨 Conversion

the convert command converts the image to a different format or color state. The format of the output file is determined from the filename extension. so yes, the extension matters, it's not just decoration bestie 😭

• --format=FORMAT — Convert to the given format. The supported formats can be listed with --format=list. go get the list, it's right there.
• --color-state=COLORSTATE — Convert to the given color state. The supported color states can be listed with --format=list. yes, same --format=list trick for the color states too, iykyk.
• --cicp=CICP — Convert to a color state that is specified as a cicp tuple. The cicp tuple must be specified as four numbers, separated by /, e.g. 1/13/6/0. four numbers, slashes between them, exactly like that.

🏷️ Relabeling

the relabel command changes the color state of an image without conversion. The format of the output file is determined from the filename extension. note the difference from convert — this one does not convert, she just relabels.

This can be useful to produce wrong color renderings for diagnostics. yes bestie, deliberately wrong colors, on purpose, for science 🔥

• --color-state=COLORSTATE — Relabel to the given color state. The supported color states can be listed with --format=list.
• --cicp=CICP — Relabel to a color state that is specified as a cicp tuple. The cicp tuple must be specified as four numbers, separated by /, e.g. 1/13/6/0.

---

heads up bestie: --cicp wants four numbers separated by /, like 1/13/6/0. not three, not five. four. don't come for me, that's just what it says 💖

---

and that's the whole page, no cap. this one's brought to you by GTK — source and version GTK, page gtk4-image-tool(1), and the manual itself is dated the same as the file you're reading. go forth and manipulate some images, you absolute icon 🎀✨👑