get_folder_info(mki-获取文件夹文件信息)

ComfyUI is great at reading files it knows about - checkpoints, LoRAs, images in its model folders - and useless at reading arbitrary folders. get_folder_info_makki (display name "get_folder_info(mki-获取文件夹文件信息)") is the exception: you give it any folder path and it scans it, filters it, sorts it, and hands you back a filename, a count, or a tree view - all as graph data you can wire into other nodes.

The realistic use case: batch processing. You point it at a folder of input images, it tells you the Nth filename, and you feed that into a loader. Or you use file_count as the loop bound for processing a folder you didn't generate in ComfyUI.

The inputs

There are a bunch, and they're all straightforward:

• folder_path - the folder to scan (e.g. C:/Users/MyUser/Documents or /home/user/documents). Required.
• file_index - which file to return in the nth_item output (1-based, sorted by your chosen order).
• output_full_path - false returns filenames, true returns full paths.
• include_subfolders - recurse into subfolders.
• file_filter - glob, e.g. *.txt or image*.png.
• file_types - all, image, text, audio, or video (extension-based).
• sort_by - name, date_modified, or size.
• sort_order - ascending / descending.
• limit - cap the returned list (0 = no limit).
• regex_filter - a regex like ^image.*\.png$ for when a glob isn't enough.

The outputs

Seven, which is a lot for a utility node, but each is a different way to look at the same scan:

• output_string - all files joined into one string, one per line.
• output_list - the same files as a proper LIST you can feed into list-consuming nodes.
• nth_item - the single file at file_index.
• tree_structure - a formatted ASCII tree of the folder (this is the nice one with include_subfolders - it renders subfolders as nested branches).
• file_count - how many files matched.
• has_files - a boolean, handy for conditional logic.
• error_message - non-empty when the path doesn't exist or isn't a folder.

Gotchas

• file_index is 1-based, and out of range returns the string "Index out of range." - which will then flow into whatever you wired nth_item to, so check it if you're feeding loaders.
• Filtering is strict about extensions when you use file_types. An uppercase .PNG may not match the lowercase extension list - set file_types to all if you're seeing mysteriously empty scans.
• A bad path doesn't crash - it returns empty outputs plus a readable error_message. That's the node being polite; wire error_message somewhere visible if you're scripting.

Installing

It's in ComfyUI-MakkiTools:

cd ComfyUI/custom_nodes
git clone https://github.com/MakkiShizu/ComfyUI-MakkiTools
cd ComfyUI-MakkiTools
pip install -r requirements.txt

Restart ComfyUI. Nothing heavy in here - it's plain os walking under the hood. For anything that needs a filename from an arbitrary folder inside your graph, this is the node.