identify(1)

💖 identify(1) — the ImageMagick glow-up page 💖

okay bestie, pull up a chair, because this is identify(1) from the General Commands Manual and it is literally the coolest little detective in the ImageMagick(1) squad. she doesn't edit anything, she just looks at your images and tells you everything she sees. nosy? yes. iconic? also yes. 🕵️♀️✨

---

🌸 NAME 🌸

identify — describes the format and characteristics of one or more image files.

---

🎀 SYNOPSIS 🎀

magick identify [options] input-file

---

🦋 OVERVIEW 🦋

so identify is a member of the ImageMagick(1) suite of tools, and her whole job is describing the format and characteristics of one or more image files. she also reports if an image is incomplete or corrupt — yes she will absolutely tell you your file is a mess, but she's never mean about it, she's just honest. 💅

here's the info she hands you:

• the image number
• the file name
• the width and height of the image
• whether the image is colormapped or not
• the number of colors in the image (this is off by default — use the -define unique=true option to turn it on)
• the number of bytes in the image
• the format of the image (JPEG, PNM, etc.)
• and finally the number of seconds it took to read and process the image

and that's just the baseline, bestie. there are so many more attributes available with the verbose option. main character info dump energy fr fr. 🌈

want more? point your browser at file:///usr/share/doc/ImageMagick-7/www/identify.html or https://imagemagick.org/script/identify.php. 🫶

---

✨ DESCRIPTION ✨

🌷 Image Settings 🌷

• -alpha option — on, activate, off, deactivate, set, opaque, copy transparent, extract, background, or shape
• -antialias — remove pixel-aliasing
• -authenticate value — decrypt image with this password
• -clip — clip along the first path from the 8BIM profile
• -clip-mask filename — associate a clip mask with the image
• -clip-path id — clip along a named path from the 8BIM profile
• -colorspace type — alternate image colorspace
• -crop geometry — cut out a rectangular region of the image
• -define format:option — define one or more image format options
• -define unique=true — return the number of unique colors in the image
• -density geometry — horizontal and vertical density of the image
• -depth value — image depth
• -endian type — endianness (MSB or LSB) of the image
• -extract geometry — extract area from image
• -features distance — analyze image features (e.g. contrast, correlation)
• -format "string" — output formatted image characteristics
• -fuzz distance — colors within this distance are considered equal
• -gamma value — of gamma correction
• -interlace type — type of image interlacing scheme
• -interpolate method — pixel color interpolation method
• -limit type value — pixel cache resource limit
• -list type — Color, Configure, Delegate, Format, Magic, Module, Resource, or Type
• -matte — store matte channel if the image has one
• -moments — report image moments
• -monitor — monitor progress
• -ping — efficiently determine image attributes
• -precision value — maximum number of significant digits to print
• -quiet — suppress all warning messages
• -read-mask filename — associate a read mask with the image
• -regard-warnings — pay attention to warning messages
• -respect-parentheses — settings remain in effect until parenthesis boundary
• -sampling-factor geometry — horizontal and vertical sampling factor
• -seed value — seed a new sequence of pseudo-random numbers
• -set attribute value — set an image attribute
• -size geometry — width and height of image
• -strip — strip image of all profiles and comments
• -unique — display the number of unique colors in the image
• -units type — the units of image resolution
• -verbose — print detailed information about the image
• -virtual-pixel method — virtual pixel access method

---

💜 Image Operators 💜

• -auto-orient — automatically orient image
• -channel mask — set the image channel mask
• -grayscale method — convert image to grayscale
• -negate — replace each pixel with its complementary color

---

🍓 Miscellaneous Options 🍓

• -debug events — display copious debugging information
• -help — print program options
• -list type — print a list of supported option arguments
• -log format — format of debugging information
• -version — print version information

---

by default, the image format of file is determined by its magic number. ✨ to specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps). and if you want standard input or output, specify 'file' as '-'. easy.

---

🙈 NOTE 🙈

okay so this is important, don't skip it. although some options appear to modify the file to be identified, the identify command is strictly read only. she is not touching your file, periodt. for instance, the crop option crops the in-memory image and then describes the result. the actual file on disk? untouched. she's just peeking, not rearranging. 👑

---

💫 SEE ALSO 💫

• ImageMagick(1)

---

👑 COPYRIGHT 👑

Copyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see file:///usr/share/doc/ImageMagick-7/www/license.html or https://imagemagick.org/license/

---

that's the whole page bestie, you ate it. now go identify something and feel powerful. 💖

anyway, this little love letter comes to you from ImageMagick, dated Date: 2009/01/10 01:00:00, and yeah — it's the identify(1) page, slay. 🌸💅🦋