Asset Metadata Importer

Added

• Statamic 6 Support
• PHP 8.5 Support
• Flexible Adapter System - Configure which metadata extraction adapter to use for each file type with fallback support
• Video File Support - FFprobe adapter for video files (MP4, MOV, AVI, MKV, etc.)
• ImageMagick Adapter - Support for PHP Imagick extension (200+ formats)
• Wildcard Support - Use '*' in extensions and adapter_mapping to process all file types
• Configuration Options:
  • adapter_mapping - Map file extensions to specific adapters
  • ffmpeg_path - Path to FFmpeg/FFprobe binary
• Documentation - Modular guides in docs/ folder (configuration, adapters, troubleshooting)

Changed

• Metadata Extraction - Refactored to use adapter-based system with 4 adapters:
  • Native (built-in PHP) - JPG, TIFF
  • Exiftool (recommended) - 100+ formats, 29k+ tags
  • FFprobe - Video files
  • ImageMagick - 200+ formats
• Configuration - Enhanced with examples and links to official documentation
• README - Streamlined (56% reduction) with links to detailed docs
• Documentation - Split into focused guides (configuration.md, adapters.md, troubleshooting.md)

Improved

• Better exception handling for missing binaries and PHP extensions
• Null-safe configuration value handling
• Wildcard support in upload/reupload listeners
• Direct links to Exiftool, FFmpeg, and ImageMagick documentation

Migration Guide

Fully backward compatible - No changes required. Existing configurations work without modifications.

To use new features:

1. Publish updated config (optional): php artisan vendor:publish --tag=statamic-asset-metadata-importer-config --force

2. Add adapter mapping:

   #89DDFF;">'adapter_mapping#89DDFF;">' #89DDFF;">=> #89DDFF;">[
       #89DDFF;">'native#89DDFF;">' #89DDFF;">=> #89DDFF;">[#89DDFF;">'jpg#89DDFF;">'#89DDFF;">, #89DDFF;">'jpeg#89DDFF;">'#89DDFF;">, #89DDFF;">'tif#89DDFF;">'#89DDFF;">, #89DDFF;">'tiff#89DDFF;">'#89DDFF;">],
       #89DDFF;">'exiftool#89DDFF;">' #89DDFF;">=> #89DDFF;">[#89DDFF;">'png#89DDFF;">'#89DDFF;">, #89DDFF;">'webp#89DDFF;">'#89DDFF;">, #89DDFF;">'avif#89DDFF;">'#89DDFF;">],  #676E95;">// Requires Exiftool
       #89DDFF;">'ffprobe#89DDFF;">' #89DDFF;">=> #89DDFF;">[#89DDFF;">'mp4#89DDFF;">'#89DDFF;">, #89DDFF;">'mov#89DDFF;">'#89DDFF;">],            #676E95;">// Requires FFmpeg
   #89DDFF;">],

3. For video support: Install FFmpeg and set ASSET_METADATA_IMPORTER_FFMPEG_PATH in .env

4. For ImageMagick: Ensure PHP Imagick extension is installed

See documentation for detailed installation instructions.

First stable release of the Statamic Asset Metadata Importer addon! 🎉🎉🎉

Say goodbye to manual metadata entry and hello to automated asset management. This addon automatically extracts embedded EXIF/IPTC metadata from your images and intelligently maps it to your Statamic asset fields.

✨ Core Features

Automatic Metadata Extraction

• Upload & forget - Automatically processes metadata on asset upload and re-upload
• Smart field mapping - Map any asset field to single or multiple metadata sources with intelligent fallback support
• Multibyte character support - Properly handles international characters (accents, non-Latin scripts, emoji, etc.)
• Overwrite control - Choose whether to preserve or update existing metadata on re-upload

Flexible Configuration

• Loose mapping mode - Enable partial matching for flexible metadata extraction without knowing exact tag names
• Configurable file types - Choose which file extensions should be processed
• Multiple metadata sources - Define fallback sources for each field (tries each in order)
• Debug mode - Detailed logging for troubleshooting and development

Performance & Compatibility

• Queue support - Process metadata imports asynchronously for better performance on large uploads
• Local and cloud storage - Works seamlessly with both local filesystems and remote storage (S3, etc.)
• Native PHP EXIF - Works out-of-the-box with JPG/TIFF using PHP's native functions
• Exiftool integration - Optional support for PNG, WEBP, AVIF and many more formats beyond basic JPEG/TIFF

🎯 Perfect For

This addon is ideal for:

• Photographers - Preserve Lightroom/Photoshop metadata in your Statamic assets
• Content creators - Automatically populate alt text and descriptions for SEO and accessibility
• Media professionals - Maintain copyright, credits, and attribution automatically
• Digital asset managers - Ensure consistency across large asset libraries
• Agencies - Save time on client projects by eliminating manual metadata entry

💡 Real-World Example

A photographer exports 100 images from Lightroom with embedded metadata (title, description, copyright, keywords). They upload them to Statamic, and this addon automatically:

1. Extracts the embedded metadata from each image
2. Maps title → alt field (for SEO and accessibility)
3. Maps copyright → copyright field
4. Maps credit → credit field
5. Maps description → description field

All 100 images are fully documented without a single manual entry. That's the power of metadata automation!

📦 Installation

Install via Composer:

composer require balotias/statamic-asset-metadata-importer

Publish the configuration file:

php artisan vendor:publish --tag=statamic-asset-metadata-importer-config

Optional: Extended Format Support

For PNG, WEBP, AVIF and enhanced metadata extraction, install Exiftool:

macOS:

brew install exiftool

Linux (Debian/Ubuntu):

apt-get install libimage-exiftool-perl

Then configure the path in your .env:

ASSET_METADATA_IMPORTER_EXIFTOOL_PATH#89DDFF;">=/usr/local/bin/exiftool

⚙️ Quick Setup

1. Configure your field mappings in config/statamic/asset-metadata-importer.php:

#89DDFF;">'fields#89DDFF;">' #89DDFF;">=> #89DDFF;">[
    #89DDFF;">'alt#89DDFF;">' #89DDFF;">=> #89DDFF;">'title#89DDFF;">'#89DDFF;">,
    #89DDFF;">'copyright#89DDFF;">' #89DDFF;">=> #89DDFF;">[#89DDFF;">'copyright#89DDFF;">'#89DDFF;">, #89DDFF;">'XMP-photoshop:Copyright#89DDFF;">'#89DDFF;">],
    #89DDFF;">'credit#89DDFF;">' #89DDFF;">=> #89DDFF;">[#89DDFF;">'credit#89DDFF;">'#89DDFF;">, #89DDFF;">'XMP-photoshop:Credit#89DDFF;">'#89DDFF;">],
#89DDFF;">],

2. Ensure your asset blueprint includes the fields you want to populate

3. Upload images - metadata is automatically extracted and mapped!

📚 Documentation

Full documentation with advanced configuration options, troubleshooting, and examples available in the README.

🧪 Quality Assurance

• 50 comprehensive tests covering all features, edge cases, and error scenarios
• 100% passing test suite
• Tested with Statamic 5.x and PHP 8.1+
• Production-ready and actively maintained

🛠️ Technical Details

• Requirements: Statamic 5.0+, PHP 8.1+
• Dependencies: miljar/php-exif, spatie/temporary-directory
• License: MIT
• Namespace: Balotias\StatamicAssetMetadataImporter

🙏 Acknowledgments

• Inspired by Image Metadata Importer
• Powered by the excellent miljar/php-exif library

---

Ready to automate your asset metadata? Install now and start saving time! 🚀

⚡ Requirements

Statamic 5.0+ PHP 8.1+ Optional: Exiftool binary for extended formats & tags support