ComfyUI Extension: comfyui-feroccustomnodes

Authored by Ferocit

Created

Updated

0 stars

This repository contains custom nodes for ComfyUI, designed to enhance your workflow with text-based operations, particularly for managing and utilizing descriptive texts.

Custom Nodes (0)

    README

    ComfyUI-Feroc Custom Nodes

    This repository contains custom nodes for ComfyUI, designed to enhance your workflow with text-based operations, particularly for managing and utilizing descriptive texts.

    Installation

    1. Clone this repository into your ComfyUI/custom_nodes/ directory:
      cd ComfyUI/custom_nodes/
      git clone https://github.com/YOUR_USERNAME/comfyui-feroc.git # Replace with your actual repository URL
      
    2. Restart ComfyUI to load the new nodes.

    Nodes Included

    1. LoadDescriptionNode (Category: Feroc)

    This node allows you to load text files from a designated descriptions folder within the comfyui-feroc directory. It's ideal for managing character descriptions, lore, or any other text snippets you frequently use in your ComfyUI workflows.

    Inputs:

    • subdirectory (Dropdown): A dynamic list of subdirectories found within the descriptions folder. An empty string represents the root descriptions folder.
    • file_name (Dropdown): A dynamic list of .txt files found within the selected subdirectory.

    Outputs:

    • description_text (STRING): The full content of the selected text file.
    • description_name (STRING): The base name of the selected description file (e.g., Tabea).

    Usage:

    Place your .txt description files inside the ComfyUI/custom_nodes/comfyui-feroc/descriptions/ folder. You can organize them into subdirectories (e.g., descriptions/characters/my_character.txt).

    First, select a subdirectory from the dropdown. Then, the file_name dropdown will populate with the .txt files available in that subdirectory.

    If the descriptions folder or a selected subdirectory is empty, an example file descriptions/examples/example.txt will be created to guide you.

    2. RandomLineFromText (Category: Feroc)

    This node selects a random line from one or more specified text files. It's useful for injecting variability into your prompts or other text inputs by drawing from a pool of predefined lines.

    Inputs:

    • seed (INT): A seed value for reproducibility of the random selection.
    • file_path_1 to file_path_5 (STRING, Optional): Absolute paths to text files from which a random line will be selected. You can provide up to 5 different file paths.

    Outputs:

    • (STRING): A concatenated string of randomly selected lines, one from each provided file path. Each line is separated by a newline character.

    Usage:

    Provide the full absolute path to your text files (e.g., C:\Users\YourUser\Documents\my_lines.txt). The node will read each file, pick a random non-empty line, and combine them into a single output string. Warnings will be printed to the console if a file is not found or an error occurs during reading.

    Example Workflow

    (Consider adding a screenshot or a brief description of a typical workflow here, e.g., connecting LoadDescriptionNode to a CLIPTextEncode node, or RandomLineFromText to inject dynamic elements into prompts.)

    Contributing

    Feel free to open issues or pull requests if you have suggestions or improvements.