info

Display comprehensive image information and metadata including dimensions, format, color space, file size, and EXIF data.

Usage

Description

The info command provides a quick way to inspect image files and retrieve detailed information about their properties, dimensions, format, and metadata. Perfect for verifying image specifications, checking file integrity, and extracting technical details before processing.

Options

Examples

Basic Usage

Scripting with JSON Output

Batch Information Gathering

Information Displayed

Standard Mode

File Information:

• File name and full path
• File size (formatted: KB, MB, GB)
• Raw file size in bytes

Image Details:

• Format type (JPEG, PNG, WebP, etc.)
• Dimensions (width × height in pixels)
• Aspect ratio (calculated)
• Color space (RGB, sRGB, CMYK, Grayscale)
• Number of channels
• Bit depth per channel
• Alpha channel presence
• Density/DPI (if available)
• Orientation value (1-8)

Verbose Mode (-v)

Everything from standard mode plus:

EXIF Metadata:

• Camera make and model
• Capture date and time
• ISO speed
• Aperture (f-number)
• Shutter speed
• Focal length
• Software used
• GPS coordinates (if available)

Color Profile:

• ICC profile data
• Color space information

Additional Metadata:

• IPTC data
• XMP data

Output Examples

Standard Output

JSON Output

{
  "file": {
    "name": "photo.jpg",
    "path": "/path/to/photo.jpg",
    "size": 2568903,
    "sizeFormatted": "2.45 MB"
  },
  "format": {
    "type": "jpeg",
    "width": 4032,
    "height": 3024,
    "space": "srgb",
    "channels": 3,
    "depth": "uchar",
    "density": 72,
    "hasAlpha": false,
    "orientation": 1
  },
  "exif": null
}

Use Cases

Quality Verification

Pre-Processing Inspection

Batch Quality Control

Metadata Extraction

Technical Details

Supported Formats

All Sharp-supported formats:

• JPEG/JPG
• PNG
• WebP
• AVIF
• TIFF
• GIF
• SVG
• HEIF/HEIC

Color Spaces

• sRGB: Standard RGB (most common)
• RGB: Generic RGB
• CMYK: Print color space
• Lab: Device-independent
• Grayscale: Single channel
• B-W: Black and white

Orientation Values

EXIF orientation tag (1-8):

• 1: Normal (no rotation)
• 2: Flipped horizontally
• 3: Rotated 180°
• 4: Flipped vertically
• 5: Rotated 90° CW + flipped
• 6: Rotated 90° CW
• 7: Rotated 90° CCW + flipped
• 8: Rotated 90° CCW

JSON Integration

Parse with jq

Parse with Node.js

const { execSync } = require("child_process");

const info = JSON.parse(
  execSync("mediaproc image info photo.jpg --json").toString(),
);

console.log(`Dimensions: ${info.format.width}×${info.format.height}`);
console.log(`Format: ${info.format.type}`);
console.log(`Size: ${info.file.sizeFormatted}`);

Parse with Python

import json
import subprocess

result = subprocess.run(
    ['mediaproc', 'image', 'info', 'photo.jpg', '--json'],
    capture_output=True,
    text=True
)

info = json.loads(result.stdout)
print(f"Dimensions: {info['format']['width']}×{info['format']['height']}")

Tips

• Use --json for scripting and automation workflows
• Verbose mode shows camera EXIF data from photos
• Pipe JSON to jq for easy parsing and filtering
• Combine with batch to inspect multiple files efficiently
• Check orientation before rotating to avoid double-rotation
• Verify color space before converting for print vs web
• Use in CI/CD to validate uploaded image specifications

Troubleshooting

No EXIF data shown

• Not all images have EXIF data
• EXIF may have been stripped during processing
• Use verbose mode (-v) to check for EXIF
• Try a specialized EXIF tool for detailed parsing

JSON parse errors

• Ensure JSON output is complete
• Check for error messages before JSON
• Validate JSON with jq or online validator

File not found

• Check file path is correct
• Verify file extension is supported
• Use absolute paths to avoid confusion

See Also

• stats - Technical image statistics
• metadata - Manage EXIF/IPTC/XMP metadata
• batch - Process multiple images
• convert - Format conversion