ComfyUI Node
Shima File Namer
Generate organized file names with collision protection, timestamps, configurable ordering, and project folders.
Shima File Namer
- full_path
- folder_path
- filename
- collision_id
- timestamp
- user_notes
◄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►
◄output_type►
◄filename_orderPRE,PRJ,BN,ET,SUF,TS,CID►
◄separator_►
◄user_notes►
◄external_project—►
◄external_folder—►
◄external_collision_id—►
◄allow_external_linkingfalse►
CategoryShima/Utilities
Inputs (17)
| Name | Type | Default | Description |
|---|---|---|---|
| base_folder | STRING | output | Base output folder (relative to ComfyUI root or absolute path). |
| project_name | STRING | project | Project name - 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. | |
| output_type | STRING | Label for output type (e.g., 'rgb', 'depth', 'mask'). Skip if blank. | |
| filename_order | COMBO | PRE,PRJ,BN,ET,SUF,TS,CID | Order of filename components. PRE=Prefix, PRJ=Project, BN=BaseName, ET=OutputType, SUF=Suffix, TS=Timestamp, CID=CollisionID. |
| separator | COMBO | _ | Character between filename parts. |
| user_notes | STRING | Optional notes to pass to downstream saver nodes for metadata. | |
| 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). | |
| allow_external_linkingopt | BOOLEAN | false | If ON, this node broadcasts/receives OUTSIDE the Island (ignores group regex) |
Outputs (6)
| Name | Type | Description |
|---|---|---|
| full_path | STRING | Complete path including folder and filename (no extension). |
| folder_path | STRING | Folder path only. |
| filename | STRING | Filename only (no extension). |
| collision_id | STRING | The collision ID used (for matching related outputs). |
| timestamp | STRING | The timestamp used. |
| user_notes | STRING | User notes passthrough for downstream savers. |