AAA_Metadata_System
Comprehensive metadata management for ComfyUI - multi-format support, smart merging, database storage, and workflow preservation. Load and save .psd, .tiff, .svg with layers, and other tools.
Package profile
- Status
- Verified
- Publisher
- @EricRollei
- Source
- GitHub
README
AAA Metadata System for ComfyUI
GitHub License Python
Advanced metadata management and multi-format image save/load system for ComfyUI with professional features for Adobe workflows and color management.
🎯 Key Highlights
🎨 Professional Format Support
- Adobe Photoshop PSD - Load and save with full layer preservation, blend modes, and layer groups
- True Vector SVG - Native SVG export with embedded metadata and scalability
- ICC Color Profile Management - Embed and preserve color profiles (sRGB, Adobe RGB, ProPhoto RGB, etc.)
- Adobe-Compatible Metadata - XMP sidecar files formatted for Photoshop, Lightroom, Bridge, and other cataloging software
- MWG-RS Compliant Regions - Face/area metadata with coordinates compatible with Adobe's region standard
📁 Multi-Format Image Support
- PNG - Full metadata embedding with workflow preservation
- JPEG - Smart 4-stage fallback for EXIF size limits
- TIFF - 16-bit support with layers and metadata
- WebP - Modern format with full metadata
- PSD - Complete Photoshop file support with layers, blend modes, and groups
📋 Comprehensive Metadata Management
- XMP Sidecar Files - Industry-standard structured metadata for Adobe applications
- TXT Summaries - Human-readable metadata descriptions
- JSON Export - Complete metadata for custom workflows
- Embedded EXIF/XMP - In-image metadata for portability
- SQLite Database - Optional centralized metadata storage
Overview
This metadata system provides professional-grade image and metadata management for ComfyUI workflows, with deep integration for Adobe software ecosystems and color-managed workflows.
🌟 Features
- Multi-format Support: Store metadata in multiple locations simultaneously for maximum compatibility with various software and workflows
- Smart Merging: Intelligently merge metadata from different sources with conflict resolution and prioritization
- Extensible Structure: Well-organized metadata structure with sections for different types of information, easily extended with custom fields
- ComfyUI Integration: Seamlessly integrates with ComfyUI nodes for workflow capture and parameter extraction
- Human-readable Output: Optional human-readable text format with context-aware descriptions for easy viewing
- MWG Standard Compliance: Follows Metadata Working Group standards for compatibility with professional software
- Workflow Data Preservation: Captures generation parameters and workflow structure for reproducibility
- Advanced Querying: Complex metadata filtering and searching with multiple query methods
- Error Recovery: Sophisticated error handling and recovery strategies to prevent data loss
- Thread Safety: Lock-based concurrency protection for multi-threaded applications
Installation
📋 Requirements
- Python 3.8+
- ComfyUI
- PyExiv2 (optional, for enhanced embedded metadata support)
- ExifTool (optional, for additional format support)
🚀 Install as ComfyUI Custom Node
Option 1: Clone Repository
- Clone this repository into your ComfyUI custom_nodes directory:
cd ComfyUI/custom_nodes
git clone https://github.com/EricRollei/AAA_Metadata_System.git
- Install required dependencies:
cd AAA_Metadata_System
pip install -r requirements.txt
- Restart ComfyUI
For detailed installation instructions, including platform-specific steps for PyExiv2 and ExifTool, see INSTALLATION.md.
Included Nodes
This package includes several ComfyUI nodes that integrate with the metadata system:
Metadata Save Image Node
Metadata Save Image Node
This node saves images with comprehensive metadata embedding. It extends ComfyUI's standard image saving capabilities with:
- Multiple Format Support: Save
Nodes in this pack
56 nodes
Nodes in this pack
56 nodes- AspectRatio2StepLatent
- CheckpointBatchInfoSetter_v074
- CheckpointInfoSetter_v074
- CheckpointInfoViewer_v074
- CheckpointParamsLoader_v074
- CheckpointTester_v074
- ColorNameToRGB_v01
- ColorSelector
- CulturalColorPaletteGenerator_v01
- EnhancedMetadataFilterNode_V2
- Eric_Color_Palette_Analyzer_v3
- Eric_Duplicate_Image_Finder_v04
- Eric_Metadata_Debugger_V2
- Eric_Metadata_Entry_V2
- Eric_Metadata_Filter_V2
- Eric_Metadata_Query_V3
- Eric_Workflow_Toolkit_v2
- EricCivitaiPromptExtractor
- EricCivitaiPromptExtractorAutoLoader
- EricLoadImageExtended
- EricLoadImageWithLayers
- EricSaveTrueSVGImage
- EricsWordCloudNode
- FileOrganizer
- FlattenNestedFiles_v2
- LoRABatchInfoSetter_v03
- LoRABulkOperations_v03
- LoRADatabaseMaintenance_v03
- LoRADatabaseStats_v03
- LoRAGalleryDisplay_v03
- LoRAGalleryWithEdit_v03
- LoRAInfoSetter_v03
- LoRAInfoViewer_v03
- LoRAParamsLoader_v03
- LoRAQuickFeedback_v03
- LoRATester_v03
- MetadataAwareSaveImage_Simple
- MetadataAwareSaveImage_v099d
- MetadataConsolidatorNode_V2
- Multi-LoRA Loader [PLATFORM_NAME]
- Multi-LoRA Loader Flux
- Multi-LoRA Loader Model-Only
- Multi-LoRA Loader Qwen
- Multi-LoRA Loader v02
- Multi-LoRA Loader Wan-i2v
- Multi-LoRA Loader Wan-t2v
- Multi-LoRA Loader Z-Image
- MyCustomNode
- PngInfoDiagnosticV3
- PngMetadataExtractorV3
- SmartImageCropper
- SplitWorkflowExtractorNode_V2
- TextOverlayNode_v04
- TriggerWordManager_v03
- Wan22_Size_Preset
- Wan22AspectRatioHelper
Sources
3 sources
Sources
3 sourcesVerified Oct 12
Verified Oct 12
Source excerpts
1 excerpt
Source excerpts
1 excerptSource context: Repo EricRollei/AAA_Metadata_System
