Skip to main content

Image Identify

Extracts metadata and technical information from an image file including format, dimensions, color space, and EXIF data.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • In Path - Path to the input image file from which to extract metadata.

Options​

This node does not have any configurable options.

Output​

  • Result - A dictionary containing the following image information:
    • Format - The image file format (e.g., JPEG, PNG, GIF, TIFF).
    • Width - The width of the image in pixels.
    • Height - The height of the image in pixels.
    • ColorSpace - The color space of the image (e.g., RGB, CMYK, Grayscale).
    • EXIF Data - Various EXIF metadata tags if present in the image.
    • GPSData - GPS coordinates if present in the EXIF data, including:
      • Latitude - Decimal latitude coordinate.
      • Longitude - Decimal longitude coordinate.

How It Works​

The Image Identify node uses ImageMagick library to analyze image files and extract comprehensive metadata. When executed, the node:

  1. Validates the input file path
  2. Loads image information using MagickImageInfo for basic properties
  3. Opens the image to access detailed EXIF metadata
  4. Extracts GPS coordinates from EXIF data if available
  5. Compiles all extracted information into a structured result object
  6. Outputs the metadata as a dictionary for use in subsequent nodes

Requirements​

  • Valid image file at the specified path
  • Supported image format with readable metadata

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid input file path
  • Input file not found at the specified path

Usage Notes​

  • Works with most common image formats including JPEG, PNG, GIF, BMP, TIFF, and others
  • Extracts both basic image properties and detailed EXIF metadata
  • GPS data is automatically converted from EXIF format to decimal coordinates
  • Only outputs metadata; the original image file is not modified
  • Processing is generally fast since it doesn't require full image loading for basic properties
  • Useful for:
    • Organizing image libraries based on metadata
    • Verifying image properties before processing
    • Extracting geolocation information from photos
    • Validating image format and dimensions
  • The output result can be used in subsequent nodes that process metadata
  • Some images may not contain EXIF data, in which case only basic properties will be available