ComfyUI Node
Shima File Saver
Save images with organized naming, metadata embedding, and optional preview.
Shima File Saver
- images
- shima.commonparams
- full_path
- folder_path
- filename
- collision_id
- timestamp
- image
◄show_previewfalse►
◄saver_enabledtrue►
◄export_imageUnprocessed►
◄user_notes►
◄export_with_metadatatrue►
◄export_with_workflowtrue►
◄export_asPNG►
◄export_quality95►
◄overwrite_modecollision_id►
◄base_folderoutput►
◄project_nameproject►
◄base_name►
◄collision_id_enabledtrue►
◄collision_id_modenew_each_run►
◄timestamp_enabledtrue►
◄timestamp_format%Y%m%d_%H%M%S►
◄prefix►
◄suffix►
◄filename_orderPRE,PRJ,BN,ET,SUF,TS,CID►
◄separator_►
◄external_project—►
◄external_folder—►
◄external_collision_id—►
◄subfolder_path►
◄use_commonparamstrue►
◄allow_external_linkingfalse►
◄show_used_valuesfalse►
CategoryShima/Output
Inputs (29)
| Name | Type | Default | Description |
|---|---|---|---|
| images | IMAGE | Image to save. | |
| show_preview | BOOLEAN | false | Display image preview below the node options. |
| saver_enabled | BOOLEAN | true | Master on/off switch. If off, node acts as passthrough (no save). |
| export_image | COMBO | Unprocessed | Label for the image type being saved. Affects filename and metadata. |
| user_notes | STRING | Optional notes stored in file metadata. Leave blank to skip. | |
| export_with_metadata | BOOLEAN | true | Embed metadata (timestamp, project, prompts, model, etc.) in file. |
| export_with_workflow | BOOLEAN | true | Embed full ComfyUI workflow JSON in file (PNG/WebP only). |
| export_as | COMBO | PNG | Output format. PNG is lossless, JPEG/WebP use quality setting. |
| export_quality | INT | 951–100 | Quality for JPEG/WebP (1-100). Ignored for PNG. |
| overwrite_mode | COMBO | collision_id | How to handle existing files: collision_id (unique), increment, overwrite, or skip. |
| base_folder | STRING | output | Base output folder (relative to ComfyUI root or absolute path). |
| project_name | STRING | project | Project Name / Folder - used as subfolder and in filename. |
| base_name | STRING | User-supplied base filename. Leave blank to omit. | |
| collision_id_enabled | BOOLEAN | true | Add 6-char random ID to prevent overwrites. |
| collision_id_mode | COMBO | new_each_run | new_each_run = unique files; fixed = same ID across runs. |
| timestamp_enabled | BOOLEAN | true | Add timestamp to filename. |
| timestamp_format | STRING | %Y%m%d_%H%M%S | Python strftime format (e.g., %Y%m%d_%H%M%S). |
| prefix | STRING | Text to prepend to filename. Skip if blank. | |
| suffix | STRING | Text to append before extension. Skip if blank. | |
| filename_order | COMBO | PRE,PRJ,BN,ET,SUF,TS,CID | Order of filename components. PRE=Prefix, PRJ=Project, BN=BaseName, ET=ExportType, SUF=Suffix, TS=Timestamp, CID=CollisionID. |
| separator | COMBO | _ | Character between filename parts. |
| shima.commonparamsopt | DICT | Configuration bundle from Shima.Commons (overrides settings). | |
| external_projectopt | STRING | Override project name from external source. | |
| external_folderopt | STRING | Override base folder from external source. | |
| external_collision_idopt | STRING | Use specific collision ID (for matched outputs). | |
| subfolder_pathopt | STRING | Optional subfolder path (useful for batch mirroring). | |
| use_commonparamsopt | BOOLEAN | true | If True, use settings from Shima.Commons bundle (Project, Folder, etc.) |
| allow_external_linkingopt | BOOLEAN | false | If ON, this node broadcasts/receives OUTSIDE the Island (ignores group regex) |
| show_used_valuesopt | BOOLEAN | false | Show actual values being used (debug) |
Outputs (6)
| Name | Type | Description |
|---|---|---|
| full_path | STRING | Complete path including folder and filename with extension. |
| folder_path | STRING | Folder path only. |
| filename | STRING | Filename with extension. |
| collision_id | STRING | The collision ID used (for matching related outputs). |
| timestamp | STRING | The timestamp used. |
| image | IMAGE | Passthrough of input image. |