ComfyUI Prompt Feeder

English | 日本語 | 中文

ComfyUI Prompt Feeder

A ComfyUI custom node that feeds text prompts from a folder one at a time. Supports three input methods: typing directly on the node, selecting .txt files from a built-in library, or looping over a line range within a single .txt file.

Screenshots

<table> <tr> <td align="center" width="50%"> <img src="docs/1_node_edit.png" width="320" alt="edit mode"><br> ① <code>edit</code> mode: type prompts directly on the node </td> <td align="center" width="50%"> <img src="docs/2_node_library.png" width="320" alt="library mode"><br> ② <code>library</code> mode: feed <code>.txt</code> files from a folder one at a time </td> </tr> <tr> <td align="center" width="50%"> <img src="docs/5_node_single.png" width="320" alt="single_file mode"><br> ③ <code>single_file</code> mode: feed one file as a plain material/word list (no wildcards) </td> <td align="center" width="50%"> <img src="docs/6_node_prompt.png" width="320" alt="prompt mode"><br> ④ <code>prompt</code> mode: feed one file as sentences, wildcards available (file version of <code>edit</code>) </td> </tr> <tr> <td align="center" width="50%"> <img src="docs/3_library.png" width="320" alt="Prompt Library"><br> ⑤ Prompt Library: a 3-pane picker for browsing/editing folders and files </td> <td align="center" width="50%"> <img src="docs/4_external_paths.png" width="320" alt="External Paths"><br> ⑥ External Paths: register other node packs' <code>.txt</code> data folders for reuse </td> </tr> </table>

Features

• Four input modes:

  • edit: type directly into the text area on the node. One prompt per line (empty lines are skipped).
  • library: reads the selected .txt files from the library, splits them into lines, and loops through them exactly like edit mode.
  • single_file: picks one .txt file from the library and feeds it as a plain word/material list, looping through a line range (start_index/end_index) within just that file. Wildcards are not expanded (enable_wildcards is disabled).
  • prompt: picks one .txt file from the library and feeds it as prompt sentences — the file version of edit, with wildcards available. One line = one prompt; start_index/end_index select a line range.

• Playback Controls:

  • ▶ Run: resets the index and starts the auto-loop.
  • ⏹ Stop: stops the auto-loop.
  • File / Folder: toggles between using only the files selected in the library (File), or every file in the folder (Folder) (library mode only).
  • 📂 Lib: opens the Prompt Library (library, single_file and prompt mode).

• Prompt Library (3-pane picker):

  • Left: data source switcher + folder tree / Middle: .txt file list (with a first-line preview) / Right: content preview + editor.
  • The EDIT button unlocks editing → edit → SAVE writes the changes back to the file.
  • The ✎ button next to the file name in the right pane renames the file (Enter to confirm, Esc to cancel; prompt-feeder-data only).
  • The ＋ New button in the middle pane creates a new .txt file and opens it directly in the same in-modal editor to write and save its content (prompt-feeder-data only).
  • Presets can be saved, loaded, and deleted. Select All / Deselect All are also available.

• Data sources (registering external paths):

  • The ⚙ button at the top-left of the library lets you register existing .txt data folders from other wildcard/prompt custom node packs, each under its own label (multiple entries supported).
  • Registered paths must stay inside the ComfyUI directory (e.g. custom_nodes/ComfyUI-Impact-Pack/wildcards, user/default/other-node/data). You can enter either an absolute path or a path relative to the ComfyUI folder.
  • Each registered path appears as a source_root choice (🧩 label) on both the node and the library, and the folder tree is scoped to just that folder — so, unlike scanning the whole custom_nodes tree, unrelated folders won't show up.
  • Registered external paths are read-only for data safety (EDIT/SAVE, ＋ New, and ✎ rename are all disabled there). Writing is always limited to prompt-feeder-data.
  • Hidden/irrelevant folders such as __pycache__, .git, node_modules, and venv are automatically excluded from the folder tree.
  • Registered external paths are stored in ComfyUI/user/default/prompt-feeder-external-paths.json.

• Preview panel:

  • Shows the current configuration's output even without running the workflow (idle preview). Updates automatically when index and related widgets change.
  • Shows a current position / total count counter in the top-right corner (e.g. 2 / 6).
  • Widgets that are irrelevant to the current mode are dimmed (semi-transparent and disabled).

• Flexible Sorting & Range (library mode):

  • Sort modes: ascending (natural sort) / descending / random (reproducible via seed).
  • Range control via start_index / end_index (per-file, see below).

• Wildcards (__name__ syntax, A1111/Impact-Pack compatible):

  • Any __name__ token in the resulting prompt (in edit, library, or prompt mode; not expanded in single_file mode) is replaced with a random line from name.txt. The file is looked up in the current source_root first, then in prompt-feeder-data, then in the other registered external paths, then in the selected directory — so wildcards from all your data sources are usable regardless of which source_root is selected.
  • Subfolders are supported: __character/hair__ maps to character/hair.txt.
  • Nested wildcards (a wildcard file's line containing another __name__ token) are expanded recursively.
  • If no matching file is found, the __name__ token is left as-is.
  • Reproducible via seed (combined with index); toggle with enable_wildcards (default on).
  • In library mode with enable_wildcards on, files referenced via __name__ from other selected files (wildcard files) are automatically excluded from the prompt list (not applied if that would exclude every file, e.g. circular references).

• Language:

  • The node and library UI is English by default (no browser-language auto-switching).
  • To use 日本語 / 中文（简体）, open the Prompt Library and switch the language selector in the header (top-right). Your choice is saved per browser and applied immediately to the library (node buttons pick it up after a page reload).
  • Node slots (inputs/outputs/tooltips) follow the official ComfyUI locale (Comfy > Locale) via locales/ (en/ja/zh nodeDefs translations, see Comfy-Org/ComfyUI#6558).

Installation

1. Copy this folder into ComfyUI's custom_nodes directory (keep the folder name as comfyui-prompt-feeder).
2. Start (or restart) ComfyUI. The Prompt Feeder node will appear in the text category.

Prompt Placement

Place your .txt files under the following directory:

ComfyUI/
└── user/
    └── default/
        └── prompt-feeder-data/      ← root folder
            ├── character/           ← subfolders supported
            │   ├── eyes.txt
            │   └── hair.txt
            └── sample.txt

• Enter a path relative to prompt-feeder-data in the node's directory field. Leave it empty to use the root folder.
• Each .txt file must be UTF-8 and up to 100KB. One line is treated as one prompt (empty lines are skipped).
• Security: access outside each data source (prompt-feeder-data and any registered external paths) is blocked (path traversal protection). Symlinks are excluded. Registering an external path itself is also limited to locations inside the ComfyUI folder — nothing outside it can be registered. Registered external paths are read-only; editing (EDIT/SAVE), creating (＋ New), and renaming (✎) are only possible in prompt-feeder-data.

Parameters

| Parameter | Description | | --- | --- | | mode | edit (type directly) / library (pick files) / single_file (feed one file as a plain material list, no wildcards) / prompt (feed one file as sentences, wildcards available) | | text | Direct-entry field (multi-line). Only used in edit mode | | source_root | Data source: prompt-feeder-data (read/write) / an external path registered via ⚙ (read-only). Used in library, single_file and prompt mode | | directory | Subfolder under source_root. Leave empty to use its root. Used in library, single_file and prompt mode | | sort_mode | ascending (natural sort/file order) / descending / random. Used in library, single_file and prompt mode | | index | The current output position. Updated automatically by Run | | start_index | Start of the read range (per file in library mode, per line in single_file / prompt mode) | | end_index | End of the read range (0 = to the end; per file in library mode, per line in single_file / prompt mode) | | seed | Used to reproduce random sorting. Only relevant when sort_mode=random | | use_selection | Whether to use the library's file selection (toggled by the File / Folder button). Only used in library mode | | file | Filename within directory (e.g. hero.txt). Only used in single_file and prompt mode; pick it via the Library's file checkbox + Apply to Node | | enable_wildcards | Whether to expand __name__ tokens in the resulting prompt (see Wildcards above). Applies to all modes |

Output: one STRING (connect it to CLIP Text Encode, etc.).

Note: file is intentionally placed last on the node (below control after generate). Despite its position, it conceptually belongs with directory — it picks a file inside that folder.

Widget availability by mode

| Item | Edit mode | Library mode | single_file mode | prompt mode | | --- | --- | --- | --- | --- | | mode | ✅ the switch itself | ✅ | ✅ | ✅ | | text | ✅ prompt source | ❌ ignored (still shown) | ❌ ignored (still shown) | ❌ ignored (still shown) | | source_root | ❌ ignored | ✅ | ✅ | ✅ | | directory | ❌ ignored | ✅ | ✅ (folder containing file) | ✅ (folder containing file) | | sort_mode | ❌ ignored (input line order is fixed) | ✅ (sorts files) | ✅ (sorts the file's lines) | ✅ (sorts the file's lines) | | index | ✅ | ✅ | ✅ | ✅ | | start_index / end_index | ❌ ignored | ⚠️ active, but the range is per file, not per line | ⚠️ active, range is per line within file | ⚠️ active, range is per line within file | | seed | ❌ ignored | ⚠️ only relevant when sort_mode=random | ⚠️ only relevant when sort_mode=random | ⚠️ only relevant when sort_mode=random | | use_selection / File/Folder button | ❌ meaningless (button is disabled) | ✅ | ❌ meaningless (button is disabled) | ❌ meaningless (button is disabled) | | selected_files | ❌ ignored | ✅ | ❌ ignored | ❌ ignored | | Lib button | ✅ (browse wildcard files; Apply to Node switches mode to library) | ✅ (pick folder + files) | ✅ (pick folder + one file) | ✅ (pick folder + one file) | | control after generate | ❌ meaningless, since seed itself is meaningless | ⚠️ only meaningful with random | ⚠️ only meaningful with random | ⚠️ only meaningful with random | | file (shown last on the node) | ❌ ignored | ❌ ignored | ✅ the target file | ✅ the target file | | enable_wildcards | ✅ | ✅ | ❌ Ignored (never expanded) | ✅ | | Preview + counter | ✅ | ✅ | ✅ | ✅ |

Widgets that don't apply are dimmed (semi-transparent, value hidden, and disabled). Their values are preserved, so switching modes back keeps your settings intact.

Notes

• Note: in library mode, start_index / end_index define a range per file, not per line. Example: with 2 files of 3 lines each, start_index=1 means "from the 2nd file onward" — i.e., from the overall 4th line. Check the preview panel's counter (x / N) for the total count.
• In single_file and prompt mode, start_index / end_index instead define a range per line within the single selected file.
• Numbers in file names (e.g. a1.txt, a10.txt) are sorted correctly in natural order.
• After selecting in the library, pressing Apply to Node applies the folder and selection to the node: it switches mode to library when multiple files (or none) are checked, or fills the file field and keeps mode unchanged when exactly one file is checked and the node was already in single_file or prompt mode.
• Multiple Prompt Feeder nodes can run independently in the same workflow.
• If a queue error occurs mid-loop, the Run button is automatically re-enabled.
• Supported format: .txt only.
• Right after registering a new external path, it may not show up in the node's own source_root dropdown until the page is reloaded (applying it via the library's Apply to Node does not require a reload).

License

MIT