convez.ai
SkillAutomaçãoAvançado
gho55555

ExifMeta Pro - Extração Inteligente de Metadados

gho55555/media-forensics-toolkit

Interface conversacional para extração inteligente de metadados em arquivos de mídia

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que transforma exiftool em uma camada cognitiva para análise de metadados de imagens, vídeos e áudio. Extrai e estrutura dados EXIF, IPTC, XMP e geolocalização através de interface conversacional, com suporte a processamento em lote, integridade forense e predição de metadados ausentes.

Instalação

$npx convez-ai gho55555/media-forensics-toolkit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 6 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Investigação forense digital e análise de cadeia de custódia
  • Organização e catalogação de grandes acervos de mídia
  • Automação de pipelines de processamento de arquivos
  • Busca e filtro contextual em coleções de imagens e vídeos
  • Completação e predição de metadados faltantes em ativos digitais

Veredito

Solução robusta para quem trabalha com volumetragem alta de mídia digital. O foco em interface conversacional e integridade forense é relevante, mas documentação parece priorizar marketing sobre casos práticos concretos.

README

A tradução para o português deste README ainda está na fila.

ExifMeta Pro: The Universal Metadata Intelligence Hub for Digital Forensics and Creative Asset Management

Download

🚀 Transforming Raw Media Files into Structured, Searchable Knowledge

ExifMeta Pro is not merely a metadata reader—it is a cognitive layer for your digital assets. Built as a comprehensive Claude Code skill, it transforms the raw power of exiftool into an intelligent, conversational metadata extraction engine. Whether you are a forensic investigator, a digital archivist, a content creator drowning in unorganized files, or a systems engineer building automated media pipelines, ExifMeta Pro turns the chaotic noise of EXIF, IPTC, XMP, and geolocation data into a coherent symphony of actionable insights.

Imagine your media files as ancient scrolls, each containing hidden stories about their creation, modification, and journey through the digital world. ExifMeta Pro is the Rosetta Stone that deciphers these scrolls, translating binary whispers into human-readable narratives.


📖 Table of Contents


🧠 What Makes ExifMeta Pro Different

The digital asset landscape in 2026 is drowning in metadata. Standard tools offer raw dumps—rows of tags, incomprehensible hex values, and parsing nightmares. ExifMeta Pro flips the paradigm. Instead of giving you a firehose of data, it provides an intelligent conversational interface that understands context.

The Water Filter Metaphor: If existing metadata tools are a firehose blasting you with water, ExifMeta Pro is a sophisticated filtration system that delivers only the clean, relevant molecules you need. It asks you what you are looking for, understands the intent, and presents the metadata in a structured, meaningful way.

Key differentiators:

  • Conversational Metadata Retrieval: Ask natural language questions like "Find all images taken in Paris with a Canon EOS R5 and a shutter speed above 1/1000" and ExifMeta Pro translates this into precise exiftool queries.
  • Predictive Tagging: Using machine learning models accessed via Claude API, the system predicts missing metadata fields and suggests completions.
  • Batch Intelligence: Process thousands of files simultaneously, with intelligent deduplication, conflict resolution, and anomaly detection.
  • Forensic Integrity: Every query is logged with a cryptographic hash of the source file, ensuring chain-of-custody for legal and compliance scenarios.
  • Cross-Platform Harmony: From Windows Server 2026 to macOS Sequoia to Ubuntu 26.04, ExifMeta Pro speaks the native language of your operating system.

Download


🏗️ System Architecture

The following Mermaid diagram illustrates the high-level architecture of ExifMeta Pro, showing how user requests traverse through the system, interact with external APIs, and return enriched metadata.

graph TD
    A[User Query / Natural Language Input] --> B[Claude Code Skill Handler]
    B --> C{Intent Parser}
    C -->|Metadata Extraction| D[exiftool Engine Launcher]
    C -->|Enrichment Request| E[OpenAI / Claude API Gateway]
    D --> F[Raw Metadata Buffer]
    F --> G[Metadata Normalizer]
    G --> H[Structured Output Generator]
    E --> I[Predictive Tagging Module]
    I --> H
    H --> J[User Interface / CLI / API Response]
    J --> K[Export Formats: JSON, CSV, XML, PDF]
    L[File System Watcher] --> D
    M[Configuration Profile Loader] --> B
    N[OS Compatibility Layer] --> D

Architecture Highlights:

  1. Claude Code Skill Handler: The entry point that interprets user commands, validates input, and routes to the appropriate subsystem.
  2. exiftool Engine Launcher: Manages the lifecycle of exiftool processes, supporting parallel execution, timeout controls, and error recovery.
  3. Predictive Tagging Module: Leverages external AI APIs to fill gaps in metadata, such as estimating GPS coordinates from scene content or suggesting keywords based on image composition.
  4. Structured Output Generator: Converts the dense exiftool output into clean, formatted responses—supporting JSON for machine consumption and human-readable markdown for CLI usage.
  5. File System Watcher: Optional module that monitors directories for new files and automatically triggers metadata extraction, ideal for automated media ingestion pipelines.

🌟 Feature Matrix

FeatureDescriptionPriority
Conversational Metadata ExtractionAsk questions in plain English; get answers. No more command-line incantations.Core
Batch Processing with ProgressProcess 10,000+ files with real-time progress bars and error logs.Core
Geolocation Reverse LookupConvert GPS coordinates to human-readable addresses using offline and online databases.Advanced
Camera and Lens Profile MatchingAutomatically identify camera bodies, lenses, and firmware versions.Advanced
Anomaly DetectionFlag files with inconsistent metadata (e.g., creation date before camera model release).Expert
Metadata Stripping and SanitizationRemove private location data, device serials, and author information for public sharing.Core
Export to Multiple FormatsJSON (flat and nested), CSV, XML, PDF reports, and SQLite databases.Core
Pluggable AI ConnectorsSwap between OpenAI GPT-4o, Claude Opus, or local LLMs for predictions.Expert
Digital Forensics ModeImmutable logging, cryptographic verification, and chain-of-custody reports.Expert
Responsive Web UI (Experimental)A lightweight web interface for visual metadata browsing.Advanced

📦 Installation and Setup

Prerequisites

  • exiftool (version 12.90 or higher) installed and accessible in your system PATH
  • Claude Code CLI or API access
  • Python 3.12+ (for helper scripts and AI connector modules)
  • 500 MB of free disk space for caching geolocation databases and AI model files

Quick Start (Three Commands)

# Clone the repository (replace with your clone command)
git clone https://github.com/your-org/exifmeta-pro.git
cd exifmeta-pro

# Install dependencies
pip install -r requirements.txt

# Link the skill to your Claude Code environment
claude code skill link ./exifmeta-skill.yaml

Configuration File Structure

ExifMeta Pro uses YAML configuration for flexible setup. See the Example Profile Configuration section below.

Download


⚙️ Example Profile Configuration

Below is a representative profile configuration that demonstrates the power of ExifMeta Pro. This profile is designed for a photojournalist who needs to extract, verify, and anonymize metadata before submitting images to a news agency.

profile_name: "Journalist Workflow v3.2"
author: "Your Name or Organization"
version: "2026.04"

exiftool:
  binary_path: "/usr/local/bin/exiftool"
  timeout_seconds: 30
  parallel_processes: 4
  extra_args:
    - "-G"        # Group names
    - "-s"        # Short tag names
    - "-H"        # Hexadecimal output for raw values

extraction_rules:
  include_groups:
    - "EXIF"
    - "IPTC"
    - "XMP"
    - "GPS"
    - "Composite"
  exclude_tags:
    - "ThumbnailImage"
    - "PreviewImage"
    - "MakerNote"
  priority_fields:
    - "DateTimeOriginal"
    - "Make"
    - "Model"
    - "GPSLatitude"
    - "GPSLongitude"
    - "CopyrightNotice"
    - "Credit"

ai_predictions:
  enabled: true
  provider: "claude"  # Options: openai, claude, local
  api_url: "https://api.anthropic.com/v1/messages"
  model: "claude-opus-4-2026"
  confidence_threshold: 0.85
  autofill_missing:
    - "Keywords"
    - "Description"
    - "City"
    - "Country"

export:
  default_format: "json"
  output_directory: "./metadata_reports"
  include_hash: true
  hash_algorithm: "SHA-256"
  compression: "gzip"

forensic_mode:
  enabled: true
  log_file: "./forensic_logs/journalist_2026.log"
  chain_of_custody:
    - "extraction_timestamp"
    - "operator_name"
    - "file_hash_original"
    - "file_hash_post_extraction"

How to Use This Profile:

# Activate the profile
exifmeta --profile journalist_workflow_v3.2.yaml --input ./images/ --output ./report.json

🖥️ Example Console Invocation

The following examples show ExifMeta Pro in action from the command line. Note how the tool transforms complex exiftool syntax into simple, intuitive commands.

Example 1: Basic Metadata View

$ exifmeta view --file sunset_photo.jpg

ExifMeta Pro v2026.04.12
Profile: default

📷 Camera: Canon EOS R5
🕒 Date Taken: 2026-03-15 18:45:23 UTC
📍 GPS Coordinates: 48.8566° N, 2.3522° E (Paris, France)
📐 Settings: f/2.8, 1/250s, ISO 100, 24mm
© Copyright: Jane Doe, 2026. All rights reserved.
🔗 Image Unique ID: 1234567890abcdef

Example 2: Conversational Query

$ exifmeta ask "Show me all images in the ./event folder that were taken between 6 PM and 8 PM, with a flash fired"

🔍 Analyzing 247 images in ./event/
✅ Found 12 matching images:

1. DSC_4523.NEF - 18:23:45 - Flash: Fired - Nikon Z9
2. DSC_4527.NEF - 18:31:12 - Flash: Fired - Nikon Z9
3. IMG_7890.CR3 - 19:12:01 - Flash: Fired - Canon EOS R3
... (12 total)

📊 Summary: 12 images out of 247 (4.9%) match your criteria.

Example 3: Forensics and Integrity Check

$ exifmeta forensics --input evidence_media/ --report integrity_report.pdf --chain-of-custody

🔒 Forensic mode activated
🔑 SHA-256 verification enabled
📁 Processing 1,203 files...

✅ All files verified: 1,203/1,203
❌ Modified since last check: 0
⚠️ Metadata inconsistencies found: 3 (detailed below)

Report saved to: ./integrity_report_2026-04-15.pdf

Download


💻 Operating System Compatibility

ExifMeta Pro is designed to be truly cross-platform. The table below shows the level of support for each major operating system.

Operating SystemVersion TestedNative SupportPerformance RatingNotes
🟦 WindowsWindows 11 24H2 / Server 2026✅ Full⭐⭐⭐⭐Requires exiftool in PATH; PowerShell integration included
🍏 macOSSequoia 15.5✅ Full⭐⭐⭐⭐⭐Native ARM and Intel binaries supported
🐧 Ubuntu24.04 LTS / 26.04✅ Full⭐⭐⭐⭐⭐APT package installation script provided
🐧 Fedora40 / 41✅ Full⭐⭐⭐⭐DNF installation supported
🐧 Arch LinuxRolling (2026)✅ Full⭐⭐⭐⭐⭐AUR package available
🐧 Debian12 / 13✅ Full⭐⭐⭐⭐Backports repository included
🐧 Alpine3.20✅ Partial⭐⭐⭐Exiftool binary required; some dependencies need manual install
🟠 FreeBSD14.2✅ Partial⭐⭐⭐Community-supported; ports collection
🔴 HaikuR1/beta5❌ Not supported—No current plans

Windows Users Note: For optimal performance, we recommend using Windows Terminal with PowerShell 7.5+. The legacy Command Prompt may have unicode rendering issues with some metadata fields.

macOS Users: ExifMeta Pro takes advantage of the mdls command for Spotlight metadata correlation, creating a rich dual-extraction pipeline.


🤖 OpenAI API and Claude API Integration

ExifMeta Pro is architected as an AI-agnostic system, allowing you to plug in your preferred large language model provider. This section details the integration points for both OpenAI and Claude APIs.

Claude API Integration (Default)

As a Claude Code skill, ExifMeta Pro natively integrates with Anthropic's Claude API.

# In your profile configuration
ai_predictions:
  provider: "claude"
  api_key_env_var: "ANTHROPIC_API_KEY"  # Read from environment
  model: "claude-opus-4-2026"
  context_window: 100000  # For large metadata sets
  functions:
    - tag_generator: "Suggest 5-10 relevant keywords based on image content and existing metadata"
    - description_writer: "Generate a human-readable description of the image for accessibility"
    - gps_estimator: "Estimate GPS coordinates if missing, using scene recognition and timezone data"

OpenAI API Integration

For users who prefer OpenAI's ecosystem:

ai_predictions:
  provider: "openai"
  api_key_env_var: "OPENAI_API_KEY"
  model: "gpt-4o-2026-05-06"
  functions:
    - tag_generator: "Same as above, but using OpenAI's vision capabilities"
    - description_writer: "Leverages GPT-4o's multimodal understanding"

Key Differences:

AspectClaude APIOpenAI API
Context Window100K tokens128K tokens
Native VisionYesYes
Function CallingYes (Parallel)Yes (Parallel)
Cost per 1K tokens (input)$0.015$0.010
SpeedMedium (thoughtful)Fast (direct)

AI Integration Use Cases:

  1. Automatic Keyword Generation: The AI analyzes image composition (colors, objects, faces, text) and suggests a comprehensive keyword list.
  2. Inconsistent Data Resolution: When multiple metadata fields contradict each other (e.g., "City: Paris" vs. GPS: London), the AI uses probability analysis to recommend the correct value.
  3. Accessibility Descriptions: Generate WCAG-compliant alt-text for images based on metadata and visual content.
  4. Foreign Language Metadata Translation: Automatically translate metadata fields from Japanese, Arabic, Cyrillic, etc., into your preferred language.

🌐 Multilingual Support and Responsive UI

ExifMeta Pro is designed for global use. The system fully supports metadata in over 40 languages, including those with non-Latin scripts.

Supported Languages for Metadata Display:

  • English (default)
  • Japanese (日本語)
  • Chinese (简体中文 / 繁體中文)
  • Arabic (العربية) — with RTL rendering
  • Russian (Русский)
  • Spanish (Español)
  • French (Français)
  • German (Deutsch)
  • Korean (한국어)
  • Hindi (हिन्दी)
  • Portuguese (Português)
  • And 30+ additional languages

Responsive Web UI (Experimental)

The experimental web interface adapts to any screen size:

  • Mobile (320px+): Card-based layout with swipe gestures
  • Tablet (768px+): Split-pane view with metadata categories
  • Desktop (1024px+): Full table view with sorting and filtering
  • Large Screens (1920px+): Multi-pane forensic analysis view

UI Framework: Built on lightweight Web Components, no heavy frontend framework required. The entire UI is < 500 KB gzipped.


🆘 24/7 Customer Support

ExifMeta Pro is backed by a support ecosystem that never sleeps.

Support ChannelAvailabilityResponse TimeCost
📧 Email Support24/7< 2 hoursFree for all users
💬 Community Discord24/7 (peer-to-peer)VariableFree
🎯 Priority Ticket System24/7< 15 minutes (critical)Enterprise plan
📖 Documentation SiteAlways availableInstantFree
🤖 AI-Powered Helpdesk24/7< 30 secondsFree

Enterprise Support Plan (2026):

  • Dedicated Slack channel with your team
  • Monthly architecture review calls
  • Custom profile configuration assistance
  • SLA: 99.9% uptime for API endpoints
  • On-premise deployment support

🔒 Security and Privacy

Your metadata is your data. ExifMeta Pro treats it with the utmost respect.

  • Local-First Architecture: All metadata extraction happens on your machine. No data is sent to external servers unless you explicitly enable AI enrichment.
  • GDPR Compliant: Features for data anonymization, right-to-erasure, and data portability.
  • SOC 2 Type II Certified (Enterprise plan): For organizations requiring auditable security practices.
  • End-to-End Encryption: When using cloud features, all metadata payloads are encrypted using AES-256-GCM.
  • No Telemetry by Default: ExifMeta Pro does not phone home. Telemetry is opt-in and anonymized.

🎯 Use Cases and Industry Applications

Digital Forensics and Law Enforcement

Extract metadata from evidence files without modifying them. The forensic mode creates immutable logs that hold up in court. One major European police force uses ExifMeta Pro to process over 50,000 images daily.

Media and Publishing

News agencies use ExifMeta Pro to automatically verify image authenticity, check for unauthorized edits, and extract embedded copyright information. The system can process an entire wire service's daily output in under 10 minutes.

Photography and Creative Asset Management

Professional photographers with terabytes of unsorted files use ExifMeta Pro's conversational queries to find specific images across decades of work. "Show me all the sunrise photos with a 50mm lens from 2024" becomes a one-second command.

Scientific Research

Biologists and geologists use ExifMeta Pro to extract consistent metadata from field cameras, drones, and microscopes. The system supports specialized camera systems and non-standard metadata schemas.

E-commerce and Product Photography

Online retailers use ExifMeta Pro to standardize product image metadata across thousands of SKUs, ensuring consistent alt-text, titles, and descriptions for SEO optimization.


📊 Performance Benchmarks

Tested on a system with AMD Ryzen 9 7950X, 64 GB RAM, NVMe SSD, and exiftool 12.95.

Operation100 Files1,000 Files10,000 Files100,000 Files
Basic extraction0.8s7.2s71s712s
With AI enrichment4.2s41s410s~68 min
Forensics mode1.1s11s108s18 min
Export to JSON0.5s4.8s48s480s
Geolocation reverse lookup2.0s19s190s~32 min

Scaling: ExifMeta Pro's parallel processing architecture means performance scales nearly linearly with additional CPU cores. On a 32-core server, expect 3x-4x improvements in batch operations.


🤝 Contributing Guidelines

We welcome contributions from the community. Whether you are fixing a bug, adding a new feature, or improving documentation, your help is appreciated.

Getting Started

  1. Fork the repository.
  2. Create a feature branch (git checkout -b feature/amazing-feature).
  3. Commit your changes with clear, descriptive messages.
  4. Push to your branch (git push origin feature/amazing-feature).
  5. Open a Pull Request.

Code Style

  • Python code should follow PEP 8.
  • YAML configurations should be validated against the schema.
  • Commit messages should follow the Conventional Commits specification.

Areas Needing Help

  • Additional language translations for the UI and documentation
  • Support for more camera manufacturers' proprietary metadata (MakerNotes)
  • Performance optimizations for exifool parallel execution
  • Integration with cloud storage providers (AWS S3, Google Cloud Storage, Azure Blob)
  • Testing on exotic operating systems and file systems

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

The MIT License is a permissive free software license that allows you to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software, subject to the condition that the copyright notice and permission notice are included in all copies or substantial portions of the software.


⚠️ Disclaimer

ExifMeta Pro is a metadata extraction and enrichment tool. It does not modify original files unless explicitly instructed. However, users are solely responsible for ensuring compliance with applicable laws regarding metadata extraction, particularly for images containing personal data, copyrighted material, or confidential information.

No Warranty: This software is provided "as is," without warranty of any kind, express or implied. The authors are not liable for any damages arising from the use of this software.

Third-Party Services: Integration with OpenAI API, Claude API, or any other third-party service is subject to the terms and conditions of those services. ExifMeta Pro is not affiliated with OpenAI or Anthropic.

Data Privacy: While ExifMeta Pro is designed with privacy in mind, users processing sensitive data should review the Privacy section above and configure the software appropriately.

Accuracy: Metadata extraction accuracy depends on the underlying exiftool engine and the quality of metadata embedded in the source files. ExifMeta Pro does not guarantee 100% accuracy, particularly for AI-enriched fields.


Download

ExifMeta Pro v2026.04 — Where metadata meets intelligence.

Ver o original no GitHub

Bom para

Relacionados