comfyui-prompt-reader-node

parameter_index

• For images containing multiple sets of parameters, such as those processed through hires-fix or refiner, you will need to modify the parameter_index to select the parameters you need

SDXL

• For images generated by SDXL and containing multiple sets of prompts, the text_g will be combined with text_l into a single prompt

Batch Read

• For batch processing, please use the Batch Loader node. When using the Batch Loader node for bulk reading, the preview image will not update, and the text box will only display the metadata of the last image.

Additional Parameters

• To read parameters other than the existing output, please connect the settings to the Parameter Extractor node.

MODEL_NAME

• MODEL_NAME is a special output that matches the model name in the metadata with the existing models on the server according to the following priority:
  1. Identical path, filename, and extension.
  2. Identical filename, and extension. e.g. sd_xl_base.safetensors will be matched with SDXL\sd_xl_base.safetensors, and vice versa.
  3. Identical filename. e.g. sd_xl_base will be matched with SDXL\sd_xl_base.safetensors, and vice versa.
  4. If a matching model cannot be found, the original name will be outputted.

Image Format

• Only PNG format supports embedding both metadata and workflow at the same time. Other formats can only embed metadata.

Duplicate Filename

• When the filename already exists, an index will be added at the end of the filename, e.g. file.png, file_1.png, file_2.png.

Hashes & Auto-Detection on Civitai

• When calculate_hash is enabled, the node will compute the hash values of checkpoint, VAE, Lora, and embedding/Textual Inversion, and write them into the metadata. After the server restarts, or a new checkpoint, VAE, Lora, or embedding/Textual Inversion is loaded, the first image generation may take a longer time for hash calculation. The hash value will be stored in temporary storage without the need for repeated calculation, until the server is restarted.
• When resource_hash is enabled, the resource hashes will be written into the metadata to support auto-detection on Civitai. This function will only run when calculate_hash is enabled.
• If you need to calculate the hash of Lora, please use the Lora Loader Node or the Lora Selector Node. The hash value of the embedding/Textual Inversion will be automatically detected from the prompt.

save_metadata_file

• When the save_metadata_file is turned on, the metadata will be saved as a TXT file with the same name alongside the image.

date_format & time_format

• For the date_format and time_format, please refer to strftime.org or www.strfti.me.

filename & path

• %counter cannot be used for path, it can only be used for filename. This %counter is slightly different from the %counter in the built-in Saver node, it will count all image files in the path.

• Please refer to the following table for placeholders supported by the filename and path.

  %seed	%date
  %steps	%time
  %cfg	%counter
  %model	%extension
  %sampler	%quality
  %scheduler

Optimal Resolution

• The model_version and aspect_ratio are used only for calculating the optimal resolution of the selected model version under the chosen aspect ratio. The calculation method is based on the Stability AI development documentation and the StableSwarmUI source code (developed by Stability AI).

refiner_start

• refiner_start refers to the proportion of steps completed when the refiner starts running, i.e., the proportion of base steps to total steps. This is used to calculate the start_at_step (REFINER_START_STEP) required by the refiner KSampler under the selected step ratio.

• For batch processing, please connect the IMAGE output of the Batch Loader Node to the image input of the Prompt Reader Node.

path

• The path supports relative paths such as ./input/ or absolute paths like C:/Users/receyuki/Pictures.
• Both \ and / are acceptable.
• You can also input a single file or a list of files into the path, in which case the image_load_limit and start_index will not function.

• Connect the SETTINGS of the Prompt Reader Node to the settings of the Parameter Extractor Node. After the first run, the parameter list will be loaded.

• Replace the original loader with the Lora Loader Node, or connect the LORA_NAME output of the Lora Selector Node to the lora_name input of other lora loaders (built-in or custom), and link the NEXT_LORA output to the lora_name input of the Prompt Saver Node. Both of these nodes have the same function, please choose according to your needs.

Multiple Loras

• If you need to load multiple Loras, please connect the Lora Loader Node or Lora Selector Node head to tail through last_lora and NEXT_LORA, and connect the NEXT_LORA at the end of the Lora chain to the lora_name input of the Prompt Saver Node.

1. Lora Loader chain

2. Lora Selector chain