# 🔀 Simple Wildcard Combinator for ComfyUI
A visual, high-performance, and feature-packed Wildcard Combinator custom node for ComfyUI.
Tired of managing dozens of messy text files or losing track of massive multi-paragraph prompts? This node brings an intuitive, visual approach to wildcard prompt generation with a 3-tier hierarchy, inline image thumbnails, a pop-up modal text editor, and smart conditional rules.
---
### ✨ Key Features
📂 *3-Tier Hierarchy Group -> Category -> Option)**:
* Organize complex multi-character or multi-environment workflows effortlessly (e.g. Person1, Person2, Environment, Lighting).
* Use clean, case-insensitive placeholders in your main scene prompt: [Person1-Clothing], [Person2-Speech], [Environment-Weather].
Reorder any group, category, or option on the fly with *▲ / ▼** buttons.
📝 *Pop-up / Modal Text Editor**:
Writing long, detailed prompts? Click the *📝** icon on any option row (or double-click the text input) to open a full-screen, focused text editor overlay.
* Live word and character counters.
Quick keyboard shortcuts: Ctrl + Enter** to save, *Escape** to close.
🖼️ *Option Thumbnails & Internal Notes**:
* Attach visual preview thumbnails (📷) to any option row. Images are automatically downscaled client-side to a compressed 120px JPEG (only 1–3 KB) to keep workflow files ultra-lightweight.
Add private descriptions / notes below each prompt (e.g. "Red Evening Dress"* or "Standing Pose") for personal overview—descriptions are excluded from the final prompt sent to the model.
🔗 *Smart Compatibility Rules (Dependencies)**:
Click the *🔗** button on any option to restrict options in other categories (e.g. If "Gala Dress" is selected for Person 1, automatically filter Location to only "Ballroom" or "Red Carpet").
💾 *JSON Presets (Import & Export)**:
* Save and export your wildcard setups as standalone .json files.
* Import saved presets directly into other workflows with a single click.
🔀 *3 Generation Modes**:
* Dynamic Syntax (Curly Braces): Outputs {opt1|opt2|...} for dynamic prompt expansion.
* Random Selection: Seed-based reproducible random choice per execution.
* Sequential Selection: Cycles through options sequentially.
⚡ *Non-Destructive Pass-Through**:
* Toggle active: False to pass your original prompt through 1:1 without disconnecting any wires or nodes.
---
### 📦 Installation
#### Method 1: Git Clone (Recommended)
Open your terminal, navigate to your ComfyUI custom_nodes folder, and clone the repository:
```bash
cd ComfyUI/custom_nodes
Description
Initial release with 3-tier hierarchy, modal text editor, thumbnails, and conditional link dependencies.