ComfyUI Save Image with Metadata Logger

A custom node for ComfyUI that automatically saves images while logging detailed generation metadata to help you track and reproduce your best results.

Features

• 💾 Saves images just like the standard Save Image node
• 📝 Automatically logs metadata to a text file with actual filenames
• ⚙️ Captures KSampler settings (seed, steps, CFG, sampler, scheduler, denoise)
• ⏱️ Tracks generation time for each image
• 🔍 JSON output for live debugging with Show Text nodes
• 🚫 Zero manual input required - everything is automatic!
• 📂 Clean text format for easy searching and reading

Why Use This Node?

Ever generated an amazing image and couldn't remember the exact settings? This node solves that problem by automatically logging every generation with:

• The actual filename of your saved image
• Full path to the file
• All KSampler parameters used
• Timestamp of generation
• How long it took to generate

All saved to an easy-to-read text file that you can search through anytime!

Installation

Method 1: Git Clone (Recommended)

1. Navigate to your ComfyUI custom nodes directory:

   cd ComfyUI/custom_nodes/

2. Clone this repository:

   git clone https://github.com/Cordux/ComfyUI-SaveImageMetaData.git

3. Restart ComfyUI

Method 2: Manual Installation

1. Download this repository as a ZIP file
2. Extract it to your ComfyUI/custom_nodes/ directory
3. Make sure the folder name doesn't have -main at the end
4. Restart ComfyUI

Requirements

No external dependencies required! This node uses only Python standard library modules.

Usage

Basic Setup

1. Add the "Save Image + Metadata Logger" node to your workflow
2. Connect the image output (from VAE Decode) to the node's images input
3. Set your filename_prefix (optional, defaults to "ComfyUI")
4. That's it! The node automatically captures everything else

Example Workflow

[KSampler] → [VAE Decode] → [Save Image + Metadata Logger]
                                        ↓
                                  (metadata_json output)
                                        ↓
                                  [Show Text] (optional, for debugging)

The node automatically extracts from your workflow:

• Seed
• Steps
• CFG scale
• Sampler name
• Scheduler
• Denoise value
• Generation time

Parameters

Parameter	Type	Description
images	IMAGE	Input images to save
filename_prefix	STRING	Prefix for saved files (default: "ComfyUI")
enable_metadata_file	BOOLEAN	Toggle metadata logging on/off (default: True)

Outputs

Output	Type	Description
metadata_json	STRING	JSON string containing all metadata (connect to Show Text for debugging)

Output Examples

Metadata Text File

The node saves all metadata to ComfyUI/output/generation_metadata.txt:

================================================================================
Generated: 2026-01-10 17:45:32
File: ComfyUI_00001_.png
Path: Path\to\ComfyUI_outputs
Seed: 938261540729183
Steps: 20
CFG: 7.5
Sampler: dpmpp_2m
Scheduler: karras
Denoise: 1.0
Generation Time: 12.34s
================================================================================

================================================================================
Generated: 2026-01-10 17:48:15
File: MyProject_00002_.png
Path: Path\to\ComfyUI_outputs
Seed: 12345605789012
Steps: 30
CFG: 8.0
Sampler: euler_ancestral
Scheduler: normal
Denoise: 1.0
Generation Time: 15.67s
================================================================================

JSON Output (for Show Text)

{
  "timestamp": "2026-01-10 17:45:32",
  "files": [
    {
      "filename": "ComfyUI_00001_.png",
      "path": "Path:\\to\\ComfyUI_outputs"
    }
  ],
  "generation_time_seconds": 12.34,
  "seed": 93826158075629183,
  "steps": 20,
  "cfg": 7.5,
  "sampler_name": "dpmpp_2m",
  "scheduler": "karras",
  "denoise": 1.0
}

Tips

• Search your metadata file - Use Ctrl+F (or Cmd+F on Mac) to quickly find specific seeds or settings
• Keep the file open - You can watch it update in real-time as you generate images
• Use Show Text - Connect the metadata_json output to a Show Text node to see the data live
• Organize by project - Use different filename prefixes for different projects
• Backup periodically - Copy the metadata.txt file to preserve your generation history

Common Use Cases

Finding the Perfect Settings

When you generate an image you love, immediately check the metadata file to find the exact settings used.

Comparing Generations

Try different settings and review the metadata file to see which combinations worked best.

Sharing Settings

When sharing images with the community, easily copy the exact settings from your metadata file.

Time Tracking

Monitor how long different sampler/scheduler combinations take to optimize your workflow.

Troubleshooting

Metadata file not being created

• Check that enable_metadata_file is set to True (it's on by default)
• Make sure ComfyUI has write permissions to the output directory
• Check the console for error messages

KSampler settings showing as "Unknown"

• Make sure you have a KSampler or KSamplerAdvanced node in your workflow
• The node needs to be connected in the workflow (even indirectly)

Generation time showing as 0.0s

• This is normal for very fast generations
• Time tracking starts when the node is initialized

Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests

Please check the Issues page before creating a new issue.

Support

If you encounter any issues:

1. Check the console/terminal for error messages
2. Look through existing Issues
3. Create a new issue with:
   • Your ComfyUI version
   • Steps to reproduce the problem
   • Any error messages

License

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

Acknowledgments

Created for the ComfyUI community to make tracking generation settings easier and more organized.

---

Note: This node is completely original and was built from scratch specifically for automatic metadata logging. If you find it useful, please star the repo! ⭐