Save as JXL, AVIF, WebP, JPEG, JPEG2k, customize the folder, sub-folders, and filenames of your images!
Supports those extensions: JXL AVIF WebP jpg jpeg j2k jp2 png gif tiff bmp
- Customize the folder, sub-folders, and filenames of your images!
- Save data about the generated job (sampler, prompts, models) as entries in a
json
(text) file, in each folder. - Use the values of ANY node's widget, by simply adding its badge number in the form id.widget_name
- Warning: ComfyUI can only load prompts from PNG and WebP atm
Attribute | Description |
---|---|
filename_prefix |
String prefix added to files. |
filename_keys |
Comma separated string with sampler parameters to add to filename. E.g: sampler_name, scheduler, cfg, denoise Added to filename in written order. resolution also works. vae_name model_name (upscale model), ckpt_name (checkpoint) are others that should work. Here you can try any parameter name of any node. As long as the parameter has the same variable name defined in the prompt object they should work. The same applies to foldername_keys . |
foldername_prefix |
String prefix added to folders. |
foldername_keys |
Comma separated string with sampler parameters to add to foldername. Add more subfolders by prepending "./" to the key name. |
delimiter |
now a free field Delimiter = 1 character, can be anything your file system supports. Windows users should still use "/" for subfolders. |
save_job_data |
If enabled, saves information about each job as entries in a jobs.json text file, inside the generated folder. Mulitple options for saving prompt , basic data , sampler settings , loaded models . |
job_data_per_image |
When enabled, saves individual job data files for each image. |
job_custom_text |
Custom string to save along with the job data. Right click the node and convert to input to connect with another node. |
save_metadata |
Saves metadata into the image. |
counter_digits |
Number of digits used for the image counter. 3 = image_001.png. Will adjust the counter if files are deleted. Looks for the highest number in the folder, does not fill gaps. |
counter_position |
Image counter first or last in the filename. |
one_counter_per_folder |
Toggles the counter. Either one counter per folder, or resets when a parameter/prompt changes. |
image_preview |
Turns the image preview on and off. |
output_ext |
File extension: PNG by default, or WEBP (coming soon). |
quality |
Quality for JPEG/JXL/WebP/AVIF/J2K formats; default 90 (AVIF only needs 60 for same results). |
named_keys |
Prefix each value by its key name: prefix-seed=123456-width=1024-etc-0001.avif |
- Unknown key names in
filename_keys
andfoldername_keys
are treated as custom strings- if you enter
wrongNumber.attribute
, you will getattribute
in your filename.
- if you enter
- Datetime UNIX format is now included!
%Y-%m-%d
or%F
etc - default it output only the name for
ckpt_name
andcontrol_net_name
- use
ckpt_path
orcontrol_net_path
in case you have subfolders for those and want to use them as subfolders
- use
- using
.custom_string
will prevent appending delimiter, the dot will be the delimiter
images
- The generated images.
Optional:
positive_text_opt
- Optional string input for when using custom nodes for positive prompt text.negative_text_opt
- Optional string input for when using custom nodes for negative prompt text.
Converts unix datetime formats:
Unix datetime | Example | Comment |
---|---|---|
%F or %Y-%m-%d | 2024-05-22 | |
%D | 05/22/24 | This effectively creates subfolders |
%F %H-%M-%S | 2024-05-22 09-13-58 | |
%Y/%V | 2024/21 | year subfolder / ISO week number subfolder |
There is a requirements.txt that will take care of that, but just in case:
- python 10.6
- piexif
- imagecodecs
- pillow
- pillow-avif-plugin
- pillow-jxl-plugin
pip install piexif pillow pillow-avif-plugin
For Jpeg XL / jxl it's more complicated. You cannot compile the wheel jxlpy on Windows. Therefore, we use an alternative: imagecodecs
pip install -U imagecodecs
- Open a terminal inside the 'custom_nodes' folder located in your ComfyUI installation dir
- Use the
git clone
command to clone the save-image-extended-comfyui repo under ComfyUI\custom_nodes\
git clone https://github.com/audioscavenger/save-image-extended-comfyui
JPEG XL is a heated debate on chromium forum and if true indeed that Google is working on WebP2, jxl is unlikely to take off any day soon. Proponents arguably declare with no proof, that jxl is better and faster than the current best codec: AVIF. But again, without support from the industry, it's going nowhere.
I tested with compression 90 and it's good, with a caveat. The compression offered by pillow is 3x lower then Image Magick for the same level. No idea why.
Pillow cannot save Exif data in JPEG2000, nor can it compress it in any way. Who the heck is using JPEG2000 in 2024 anyway?
Disclaimer: Does not check for illegal characters entered in file or folder names. May not be compatible with every other custom node, depending on changes in the prompt
object.
Tested and working with default samplers, Efficiency nodes, UltimateSDUpscale, ComfyRoll, composer, NegiTools, and 45 other nodes.
Quality and compression settings: default is 90, 100 will activate lossless for AVIF and WEBP only.
Quick comparison of size per extension, for the same 512x512 picture, with similar visual quality:
Ext | Compression | Maker | Size | Compression |
---|---|---|---|---|
png | max 9 | PIL | 413111 | 0% |
j2k | n/a | PIL | 395028 | 4% |
jxl | lossless | PIL | 301310 | 27% |
jxl | 90 | PIL | 179210 | 57% |
jpeg | 90 | PIL | 88554 | 79% |
avif | 90 | Imagick | 67272 | 84% |
webp | 90 | Imagick | 64416 | 84% |
webp | 90 | PIL | 64356 | 84% |
avif | 60 | PIL | 47353 | 89% |
avif | 60 | Imagick | 33691 | 92% |
About extensions WebP AVIF JPEG JXL: ComfyUI can only load PNG and WebP atm... Feel free to ask ComfyUI team to add support for AVIF/jpeg/JXL!
The metadata Are included under the EXIF tags IFD below, as defined here WAS Node Suite also use those tags. They must be next to each other in order to Comfy to be able to load them with drag and drop.
Data | EXIF | Name | String looks like |
---|---|---|---|
prompt | 0x010f | Make | Prompt: {"5" ... } |
workflow | 0x010e | ImageDescription | Workflow: {"5" ... } |
You can retrieve the prompt manually with exiftool, here are some example commands:
exiftool -Parameters -Prompt -Workflow image.png
exiftool -Parameters -UserComment -ImageDescription image.{jpg|jpeg|webp|avif|jxl}
ComfyUI cannot load lossless WebP atm. Feel free to try and fix pnginfo.js
Incompatible with extended-saveimage-comfyui - This node can be safely discarded, as it only offers WebP output. My node already adds JPEG and WebP.
You asked for it... Now you can select which node to get the widget values from! Formerly, this custom node would simply return the last value found: useless if you have multiple same nodes...
To see node numbers in the UI, enable the badge IDs:
jobs.json sample: always generated and appended, not sure what it can be used for.
Reboot by AudioscavengeR since 2024-05-05, original idea from @thedyze
I won't promise you the moon, but since I use this node myself, I will maintain it as much as I can. I do provide a way to contact me, and will accept PR and collabs. Once I feel like I don't have time to work on it, I will gladly transfer ownership or let collabs maintain it.
TODO:
- accept multiple images as input
- improve get_latest_counter: restarts when user renames files after the counter part.
- offer to place the counter anywhere, as a key in filename_keys
- keep same counter if extension changes?
- files will be out of order if prefixes change... that is expected, but is this what we want?
- brought back resolution
- Prefix each value by its key name: prefix-seed=123456-width=1024-etc-0001.avif
- updated help popup and minor cosmetic fixes
- added ckpt_path and control_net_path in case you have subfolders for those: default it output only the name
- complete fix of save_images() which allows for use of subfolders in filename_keys
- tried VALIDATE_INPUTS() but all it does is checking 1 single value, no correction
- added JPEG-XL
- added JPEG2000
- fixed help popup text color in dark mode
- published in comfy-registry
- added Help at top-right corner, based off KJNodes
- fixed negative_prompt job save overwritten by positive_prompt
- remove job_custom_text? no, some ppl use it apparently
- remove jobs.json? no, some ppl use it apparently
- ComfyRoll CR XY Save Grid Image: it offers jpeg webp tif - check how it embeds prompt - nope it does not
- prompt and workflow are saved in IFD 270 and 271 for better load compatibility
- disabled jobs.json by default, this thingy seems useless to me
- added quality input
- added extensions jpeg, gif, tiff, bmp
- added image_optimization (only for jpeg)
- now saves prompt and workflow separately into 0x9286/UserComment and 0x010e/ImageDescription
- added unix datetime formats
- added JXL support
- added 'BOOLEAN' support
- bug discovered with rgthree's Ksampler Config: using
steps_total
as an input to a Ksampler, will issue the index of the output, instead of the steps value ("[nodeNum, 0]" instead of steps value). FIX: usesteps_total
instead ofsteps
! - uncommented
__all__
in init.py - potential bugfix in splitKey,
len(splitKey) = 2
to identify actual "node.widget" format
- added ๐พ in the name
- so many bugfixes
- complete rework of generate_custom_name to handle ALL the possible scenarios
- bugfix: when using
/name
in foldername_keys, Comfy thinks you want to save outside the output folder
- support for AVIF
- added requirements.txt
- fixed counter for variable file extensions length
- bugfix WebP encoding: Comfy could partially read the prompt, but the way they implemented it was buggy. PR fix submitted.
- WebP is indeed loaded properly like a PNG, if you apply the patch above to
pnginfo.js and
app.js`
- integrate webp
- integrate jpeg
- for each keys, we return only the last value found in the prompt. Not the last Ksampler. Impossible to know which one is the last. Therefore, simply use this syntax: number.widget_name
- filename_keys and foldername_keys become too large, switch to multiline
- also removes subfolders from values found, when people use subfolders like SD15/pytorch_blah.pt etc
- added what I was looking for the last 6 months in the first place: 123.attribute from nodes!
- limit delimiter to 1 char, or file counter will get too complex
- delimiter is now whatever you want, free field. Limited to 16 characters tho
- all is instance methods, previously we had @staticmethods. Why? Don't know.
- check get_latest_counter: does it still work with subfolders? yessir
- bugfix: custom_name was not updated for int and floats
- now accepts inexistant keys and use them as fixed strings
- now accepts inexistant keys with / and use them as subfolders
- Reboot on 2024-05-05
Like my work? This tool helped you? Want to sponsor more awesomeness like this?