🎯 DebugPadawan's ComfyUI Essentials

Essential custom nodes for ComfyUI workflows

---

✨ Features

🔤 Text Processing	Split, join, and manipulate text strings with precision
📦 Data Conversion	Convert between text and JSON formats easily
🐛 Debug Tools	Print and inspect values during workflow execution
⏱️ Timing Control	Add delays and timing control to your workflows
🔧 Utilities	Essential helpers for workflow optimization

---

🚀 Installation

# Navigate to your ComfyUI custom nodes directory
cd ComfyUI/custom_nodes

# Clone the repository
git clone https://github.com/DebugPadawan/DebugPadawans-ComfyUI-Essentials.git

# Restart ComfyUI

---

📦 Available Nodes

🔤 Text Processing

📝 Text Splitter - Split text strings by delimiter

Category: DebugPadawan/Text

Splits a text string at a specified delimiter and returns a list of strings.

📥 Inputs:

• text (String): The text to split (supports multiline input)
• delimiter (String): The character(s) to split by (default: ",")
• strip_whitespace (Boolean, optional): Remove leading/trailing whitespace (default: True)
• remove_empty (Boolean, optional): Remove empty strings from result (default: True)

📤 Outputs:

• text_list (List): The split list of strings
• count (Integer): Number of elements in the list

💡 Example:

Input: "apple, banana, orange"
Delimiter: ","
Output: ["apple", "banana", "orange"] and 3

Process CSV-like data, split tag lists, separate coordinates, create filename lists, parse prompt components.

🔗 Text Joiner - Combine strings with custom delimiters

Category: DebugPadawan/Text

Combines a list of strings into a single text string with a customizable delimiter.

📥 Inputs:

• text_list (List): List of strings to join
• delimiter (String): Character(s) to join with (default: ", ")
• prefix (String, optional): Text to add at the beginning
• suffix (String, optional): Text to add at the end

📤 Outputs:

• joined_text (String): The combined text string

💡 Example:

Input: ["red", "green", "blue"]
Delimiter: " | "
Prefix: "Colors: "
Suffix: " - end"
Output: "Colors: red | green | blue - end"

Combine prompt parts, convert lists to readable text, create metadata tags, build filenames, format output strings.

🔄 Text Replace - Replace specific text in a string

Category: DebugPadawan/Text

Replaces all occurrences of a specific substring within a text string.

📥 Inputs:

• text (String): The text to process
• find (String): The substring to search for
• replace (String): The string to replace it with

📤 Outputs:

• text (String): The modified text string

💡 Example:

Input: "A beautiful sunset over the ocean"
Find: "sunset"
Replace: "sunrise"
Output: "A beautiful sunrise over the ocean"

Useful for dynamically adjusting prompts, modifying paths, and cleaning up generated text.

---

📦 Data Conversion

🗃️ TextToJSON - Convert text to JSON

Category: DebugPadawan/JSON

Converts a valid JSON string into a JSON object, enabling further data processing or integration with other nodes.

📥 Inputs:

• text (String): The text to parse as JSON

📤 Outputs:

• json (JSON/Object): The parsed JSON object

💡 Example:

Input: '{"name": "Alice", "age": 30}'
Output: { "name": "Alice", "age": 30 }

Use this node to quickly transform JSON-formatted text into a usable data structure for your ComfyUI workflows.

---

🐛 Debug Tools

🖨️ Debug Print - Console output for debugging

Category: DebugPadawan/Debug

Prints values to the console without interrupting the workflow. Perfect for debugging and monitoring data values during execution.

📥 Inputs:

• value (Any): Any value to print to console (supports all data types)
• label (String, optional): Label for the debug output (default: "Debug")

📤 Outputs:

• passthrough (Any): The same value passed through unchanged

💻 Console Output:

[MyLabel] list: ['Element1', 'Element2', 'Element3']
[Debug] str: Hello World
[Checkpoint] int: 42
[Data Flow] dict: {'key': 'value', 'count': 5}
[Boolean Test] bool: True
[Float Value] float: 3.14159

Monitor values during execution, debug complex workflows, verify data types, set checkpoints, troubleshoot unexpected results.

---

⏱️ Timing Control

⏳ Wait - Add delays to workflow execution

Category: DebugPadawan/Timing

Pauses workflow execution for a specified duration. Useful for rate limiting, timing control, or debugging workflow sequences.

📥 Inputs:

• value (Any): Any value to pass through after the delay
• delay_seconds (Float): Duration to wait in seconds (default: 1.0)
• label (String, optional): Label for console output (default: "Wait")

📤 Outputs:

• passthrough (Any): The same value passed through after delay

💻 Console Output:

[Wait] Waiting for 2.5 seconds...
[Wait] Wait completed.
[Custom Timer] Waiting for 5.0 seconds...
[Custom Timer] Wait completed.

Rate limit API calls, debug timing issues, control workflow execution speed, add pauses between operations, synchronize parallel processes.

⚠️ Note: Use with caution in production workflows as it will genuinely pause execution.

---

🖼️ Image Utilities

📐 Image Info - Extract image tensor dimensions

Category: DebugPadawan/Image

Extracts the width, height, and batch size from a ComfyUI Image tensor.

📥 Inputs:

• image (Image): The image tensor to analyze

📤 Outputs:

• width (Integer): Image width in pixels
• height (Integer): Image height in pixels
• batch_size (Integer): Number of images in the batch

Useful for dynamic resizing, conditional logic based on aspect ratio, or passing dimensions to other nodes.

---

🔧 Utility Nodes

📊 List Info - Analyze list properties

Category: DebugPadawan/Utilities

Analyzes a list and returns useful information about it.

📥 Inputs:

• input_list (List): The list to analyze

📤 Outputs:

• count (Integer): Number of elements
• first_item (String): First element (as string)
• last_item (String): Last element (as string)

Validate list processing results, get quick statistics, check if lists are empty, extract boundary values.

🔀 Conditional String - Boolean-based string selection

Category: DebugPadawan/Logic

Returns one of two strings based on a boolean condition.

📥 Inputs:

• condition (Boolean): The condition to evaluate
• true_string (String): String to return if True (default: "True")
• false_string (String): String to return if False (default: "False")

📤 Outputs:

• result (String): The selected string

Conditional prompt modification, dynamic filename generation, workflow branching, status message generation.

---

🎨 Quick Start Examples

Basic Text Processing

"apple,banana,orange" → Text Splitter → ["apple", "banana", "orange"]
                                    ↓
["apple", "banana", "orange"] → Text Joiner → "apple | banana | orange"

Text to JSON Conversion

'{"foo": "bar"}' → TextToJSON → { "foo": "bar" }

Debug Workflow

Input Data → Debug Print ("Input") → Processing Node → Debug Print ("Output") → Result

Timed Processing

Data → Wait (2.0s) → Processing → Wait (1.0s) → Output

---

📋 Node Categories

Category	Nodes	Purpose
DebugPadawan/Text	Text Splitter, Text Joiner, Text Replace	Text manipulation and processing
DebugPadawan/JSON	TextToJSON	Text to JSON conversion
DebugPadawan/Debug	Debug Print	Debugging and monitoring
DebugPadawan/Timing	Wait	Timing control and delays
DebugPadawan/Utilities	List Info	Data analysis helpers
DebugPadawan/Logic	Conditional String	Conditional operations
DebugPadawan/Image	Image Info	Image tensor analysis

---

🤝 Contributing

We welcome contributions! Feel free to:

• 🐛 Report bugs
• 💡 Suggest new features
• 🔧 Submit pull requests
• 📖 Improve documentation

---

📄 License

This project is licensed under the MIT License.

---

Made with ❤️ by DebugPadawan