Nodes/shima_wf/Shima File Namer
ComfyUI Node

Shima File Namer

Generate organized file names with collision protection, timestamps, configurable ordering, and project folders.

By KDB-USJP·Created 5 months ago·Updated 5 months ago· 1
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)

    NameTypeDefaultDescription
    base_folderSTRINGoutputBase output folder (relative to ComfyUI root or absolute path).
    project_nameSTRINGprojectProject name - used as subfolder and in filename.
    base_nameSTRINGUser-supplied base filename. Leave blank to omit.
    collision_id_enabledBOOLEANtrueAdd 6-char random ID to prevent overwrites.
    collision_id_modeCOMBOnew_each_runnew_each_run = unique files; fixed = same ID across runs.
    timestamp_enabledBOOLEANtrueAdd timestamp to filename.
    timestamp_formatSTRING%Y%m%d_%H%M%SPython strftime format (e.g., %Y%m%d_%H%M%S).
    prefixSTRINGText to prepend to filename. Skip if blank.
    suffixSTRINGText to append before extension. Skip if blank.
    output_typeSTRINGLabel for output type (e.g., 'rgb', 'depth', 'mask'). Skip if blank.
    filename_orderCOMBOPRE,PRJ,BN,ET,SUF,TS,CIDOrder of filename components. PRE=Prefix, PRJ=Project, BN=BaseName, ET=OutputType, SUF=Suffix, TS=Timestamp, CID=CollisionID.
    separatorCOMBO_Character between filename parts.
    user_notesSTRINGOptional notes to pass to downstream saver nodes for metadata.
    external_projectoptSTRINGOverride project name from external source.
    external_folderoptSTRINGOverride base folder from external source.
    external_collision_idoptSTRINGUse specific collision ID (for matched outputs).
    allow_external_linkingoptBOOLEANfalseIf ON, this node broadcasts/receives OUTSIDE the Island (ignores group regex)

    Outputs (6)

    NameTypeDescription
    full_pathSTRINGComplete path including folder and filename (no extension).
    folder_pathSTRINGFolder path only.
    filenameSTRINGFilename only (no extension).
    collision_idSTRINGThe collision ID used (for matching related outputs).
    timestampSTRINGThe timestamp used.
    user_notesSTRINGUser notes passthrough for downstream savers.