73 lines
2.6 KiB
Markdown
73 lines
2.6 KiB
Markdown
# ComfyUI Wireless Toggle Master
|
|
|
|
Control any nodes in your ComfyUI workflow by **title** or **color** matching. Toggle nodes on/off with a single click, with optional radio-button style restrictions.
|
|
|
|
## Features
|
|
|
|
- 🎯 **Wireless** - No connections needed! Control nodes anywhere in your workflow
|
|
- 🔍 **Regex Matching** - Filter nodes by title using regular expressions
|
|
- 🎨 **Color Matching** - Filter nodes by their node color
|
|
- 📦 **Subgraph Support** - Works across nested subgraphs
|
|
- 🔘 **Radio Mode** - Optional "max one" or "always one" restriction for exclusive selection
|
|
|
|
## Sample Workflow
|
|
|
|
|
|
|
|
*Example: Using Wireless Master Toggle to switch between fruit options with "always one" restriction*
|
|
|
|
📥 **[Download Sample Workflow](workflows/Toggle%20Master%20Sample.json)** - Load this into ComfyUI to try it out!
|
|
|
|
## Installation
|
|
|
|
### ComfyUI Manager (Recommended)
|
|
Search for "Wireless Toggle Master" in ComfyUI Manager and install.
|
|
|
|
### Manual Installation
|
|
```bash
|
|
cd ComfyUI/custom_nodes
|
|
git clone https://github.com/jonstreeter/comfyui-togglemaster
|
|
```
|
|
|
|
Restart ComfyUI after installation.
|
|
|
|
## Usage
|
|
|
|
1. Add **Wireless Master Toggle** node (found in `utils` category)
|
|
2. Right-click the node → **Properties Panel**
|
|
3. Set your filter criteria:
|
|
- `matchTitle`: Regex pattern (e.g., `^Char.*` for nodes starting with "Char")
|
|
- `matchColors`: Comma-separated colors (e.g., `red, #ff0000`)
|
|
4. Toggle matching nodes on/off using the generated toggle widgets
|
|
|
|
### Properties
|
|
|
|
| Property | Type | Description |
|
|
|----------|------|-------------|
|
|
| `matchTitle` | string | Regex pattern to match node titles |
|
|
| `matchColors` | string | Comma-separated list of colors to match |
|
|
| `showNav` | boolean | Show navigation arrows |
|
|
| `showAllGraphs` | boolean | Include nodes from subgraphs |
|
|
| `sort` | combo | Sort order: `position` or `alphanumeric` |
|
|
| `toggleRestriction` | combo | `default`, `max one`, or `always one` |
|
|
|
|
### Toggle Restriction Modes
|
|
|
|
- **default**: Multiple nodes can be enabled simultaneously
|
|
- **max one**: At most one node can be enabled at a time
|
|
- **always one**: Exactly one node is always enabled (radio button behavior)
|
|
|
|
## Example Use Cases
|
|
|
|
- **Character Selection**: Match nodes named `Char_A`, `Char_B`, etc. with "always one" for exclusive character selection
|
|
- **Style Presets**: Toggle between different style/LoRA preset nodes
|
|
- **A/B Testing**: Quickly switch between alternative workflow branches
|
|
|
|
## License
|
|
|
|
MIT License
|
|
|
|
## Credits
|
|
|
|
Inspired by [rgthree-comfy](https://github.com/rgthree/rgthree-comfy) Fast Groups Muter/Bypasser nodes.
|