⭐ Star Image Loader Options
Read your own metadata back out of an image and feed it into the workflow
- metadata
- StarMetaData 1
- StarMetaData 2
- StarMetaData 3
- StarMetaData 4
- StarMetaData 5
- lookup_value
- raw_json
ComfyUI already embeds your whole workflow into every PNG you save, but pulling values back out of that metadata and into the graph is awkward - it's JSON soup until you parse it. Star Image Loader Options is the node that sits on the other end of the StarNodes metadata system: it takes the STAR_METADATA bundle that ⭐ Star Load Image+ produces, shows you everything in it, and hands the important bits back as plain strings you can actually use.
What it does
The node's own description is the cleanest summary: display all metadata stored in an image, and output the 5 custom StarMetaData values for reuse in the workflow. Those five values are the labels that ⭐ Star Save Image+ / ⭐ Star Metadata Saver Option stamp onto an image when you save it - think "batch name", "seed used", "prompt theme", whatever key/value pairs you chose to record. When you later load that PNG with Star Load Image+, its metadata output plugs straight in here, and each of the five stored values comes out on its own StarMetaData 1 through StarMetaData 5 output.
Then there's the general-purpose half. Type any key into lookup_key and the matching value appears on lookup_value - so you can pull any metadata field (the standard ComfyUI workflow string, custom fields, whatever) without fishing through raw text. And raw_json dumps the whole metadata blob as formatted JSON when you want to see absolutely everything or hand it to a text-processing node.
Inputs
metadata- theSTAR_METADATAoutput from ⭐ Star Load Image+. Required, and it's a custom type, so it only plugs into nodes that speak that type.lookup_key- optional; any metadata key name to query.
Outputs
StarMetaData 1–StarMetaData 5(STRING) - the five custom values, ready to wire into text displays, filename builders, or even a prompt.lookup_value(STRING) - the value for whatever key you typed.raw_json(STRING) - all metadata, formatted.
Where it fits
The workflow it completes is: generate → ⭐ Star Save Image+ with metadata → later, ⭐ Star Load Image+ → this node → rebuild the filename or conditions from what you recorded. It turns your output folder into a loose database, which is exactly what you want when you batch a hundred variations and need to know which parameters made the good one.
Installing
Part of the StarNodes pack - install Starnodes via ComfyUI Manager, or:
cd ComfyUI/custom_nodes
git clone https://github.com/Starnodes2024/ComfyUI_StarNodes
cd ComfyUI_StarNodes
pip install -r requirements.txt
Restart, then search star on the canvas. No models needed.
Common issues
If lookup_value comes back empty for a key you're sure is there, check the exact spelling - metadata keys are case-sensitive and the node matches literally. And note the metadata input is a custom type; the node won't accept a plain STRING. If you don't see the five values, the image you loaded was probably saved by a non-StarNodes save node - there are no custom StarMetaData fields in it, which is fine, the raw_json path still works.
Inputs (2)
| Name | Type | Default | Description |
|---|---|---|---|
| metadata | STAR_METADATA | metadata output of ⭐ Star Load Image+. | |
| lookup_key | STRING | Optional: type any metadata key (or custom field name) and get its value from the lookup_value output. |
Outputs (7)
| Name | Type | Description |
|---|---|---|
| StarMetaData 1 | STRING | Custom metadata value 1. |
| StarMetaData 2 | STRING | Custom metadata value 2. |
| StarMetaData 3 | STRING | Custom metadata value 3. |
| StarMetaData 4 | STRING | Custom metadata value 4. |
| StarMetaData 5 | STRING | Custom metadata value 5. |
| lookup_value | STRING | Value of the key typed into lookup_key. |
| raw_json | STRING | All metadata as formatted JSON. |