Sign in

Nodes Browser

ComfyDeploy: How JH XMP Metadata Nodes works in ComfyUI?

What is JH XMP Metadata Nodes?

These are custom nodes for ComfyUI for the loading and saving of metadata in XMP format. XMP metadata is embedded in the images created by these nodes; it travels along wherever the image does. Both macOS and Windows index XMP metadata automatically, making it searchable from the Finder on the Mac or the File Explorer in Windows. Apps like Photoshop or Lightroom (and presumably many others) expose XMP metadata and allow it to be edited.

How to install it in ComfyDeploy?

Head over to the machine page

  1. Click on the "Create a new machine" button
  2. Select the Edit build steps
  3. Add a new step -> Custom Node
  4. Search for JH XMP Metadata Nodes and select it
  5. Close the build step dialig and then click on the "Save" button to rebuild the machine
<div align="center"> <img src="https://github.com/user-attachments/assets/d37df1a3-3baf-43f0-bd67-e75df631a265" /> </div> <div align="center"> <img src="https://img.shields.io/github/license/ComfyUI-JH/ComfyUI_JH_XMP_Metadata_Nodes"> &emsp; <img src="https://img.shields.io/github/actions/workflow/status/ComfyUI-JH/ComfyUI-JH-XMP-Metadata-Nodes/ci.yml?label=ci"> &emsp; <img src="https://img.shields.io/github/last-commit/ComfyUI-JH/ComfyUI_JH_XMP_Metadata_Nodes/main"> &emsp; <img src="https://img.shields.io/github/issues/ComfyUI-JH/ComfyUI_JH_XMP_Metadata_Nodes"> &emsp; <img src="https://img.shields.io/github/issues-pr/ComfyUI-JH/ComfyUI_JH_XMP_Metadata_Nodes"> </div> <div align="center">

Getting Started | Nodes | Credits

</div>

JH XMP Metadata Nodes

Custom nodes for loading and saving images with embedded XMP metadata (https://www.adobe.com/products/xmp.html).

When I generate tens or hundreds of images from ComfyUI they all go into a folder and get forgotten because I have no practical way to find them again. Embedded metadata solves this problem. When metadata is present in a file, both macOS and Windows index it automatically, making it searchable from the Finder on the Mac or the File Explorer in Windows.

<br /> <div align="center"> <img width="250" alt="image" src="https://github.com/user-attachments/assets/7d7e5c93-fe33-409e-86fa-0a565bfdd6f1" align="middle" /> &emsp; <img width="450" alt="image" src="https://github.com/user-attachments/assets/9effa555-1ddd-49c9-9459-53ceccdd9fef" align="middle"/> </div> <br /> <div align="center"> <img width="250" alt="image" src="https://github.com/user-attachments/assets/46e429a8-4918-416a-98a7-cebf000b0756" align="middle" /> &emsp; <img width="400" src="https://github.com/user-attachments/assets/664917ff-b87e-4a0c-8685-4e65c9299dad" align="middle" /> </div> <br />

Apps like Photoshop and Lightroom expose XMP metadata and allow it to be viewed or edited.

<br /> <div align="center"> <img width="400" alt="image" src="https://github.com/user-attachments/assets/3af31cad-9fca-4de4-97fe-f9c28cf65289" align="middle" /> &emsp; <img width="244" alt="image" src="https://github.com/user-attachments/assets/cdb8f93a-8c30-4f32-9f2a-242bdcf42f62" align="middle" /> </div> <br />

Supported Properties

The following metadata properties are currently supported:

| Property | Description | | --- | --- | | dc:creator | A creator or list of creators of the image. Items can be separated by commas (John Doe, Jane Doe) or semicolons (John Doe; Jane Doe) | | dc:rights | Information about the rights and clearances associated with the image, if any. | | dc:title | A title for the image. | | dc:description | A description of the image. | | dc:subject | A subject or list of subjects. Items can be separated by commas (wetsuit, sunset) or semicolons (wetsuit; sunset) | | photoshop:Instructions | Special instructions. | | exif:UserComment | Any user-provided comment about the image. | | Iptc4xmpCore:AltTextAccessibility | Alt. text that can (in principle) be used by assistive technologies. | | Iptc4xmpCore:ExtDescrAccessibility | A longer, more detailed elaboration of the Iptc4xmpCore:AltTextAccessibility property |

Getting Started

Installing from GitHub

  1. Install ComfyUI

  2. Clone this repository into the custom_nodes folder:

    cd ComfyUI/custom_nodes
git clone https://github.com/ComfyUI-JH/ComfyUI_JH_XMP_Metadata_Nodes.git

  3. Install the required Python packages. If you're using venv and pip that looks like this:

    cd ComfyUI_JH_Misc_Nodes
pip install -r requirements.txt

    If you're using Poetry, then it's just

    cd ComfyUI_JH_Misc_Nodes
poetry install

Nodes

Load Image With XMP Metadata

<div align="center"> <img width="1333" alt="image" src="https://github.com/user-attachments/assets/25998b31-366e-4255-80f0-a5b94edb4e41" align="middle" /> </div> <br />

Just like the built-in Load Image node except if XMP metadata is embedded in the image it will be parsed and made available on the node's outputs. The xml_string output carries the entire XML data structure including metadata which is not specifically supported by this package.

Save Image With XMP Metadata

<div align="center"> <img width="500" alt="image" src="https://github.com/user-attachments/assets/b30e9591-44c6-4e47-8e0e-9f65d392e7e9" align="middle" /> </div> <br />

Saves any images piped into it with embedded XMP metadata. All inputs (except images) are optional. Can save in a variety of file formats: JPEG, PNG (with and without embedding the ComfyUI workflow), WebP (lossy and lossless).

Get Widget Value

<div align="center"> <img width="1017" alt="image" src="https://github.com/user-attachments/assets/2369d34c-62c3-4bab-9b4b-9abf75aaa0b5" align="middle" /> </div> <br />

Can be used to get the string, int or float value of any widget on any node. Simply pipe the node into this node's input and type in the name of the widget you want the value of.

Path to Stem

<div align="center"> <img width="1309" alt="image" src="https://github.com/user-attachments/assets/082f265d-898c-4437-a20f-9d3f5057a3cb" align="middle" /> </div> <br />

Given a path string (absolute or relative), this node returns the "stem," meaning the filename alone minus any extension.

Format Metadata

<div align="center"> <img width="400" alt="image" src="https://github.com/user-attachments/assets/66065daf-3ba4-42b6-b0fa-72673d16aa25" align="middle" /> </div> <br />

This utility node takes common workflow inputs (prompt, model_name, seed, etc.) and allows you to construct a string that can subsequently be piped into a Save Image With XMP Metadata node input to embed metadata however you choose.

Credits

This software includes source code from other products:

| Product | Code Used | License | | --- | --- | --- | | ComfyUI | Code from the Load Image and Save Image nodes. | GitHub License | | ComfyUI-Custom-Scripts | The AnyType class and its implementation. | GitHub License |