DaPaLi
36153acd78
Add full documentation with usage examples and wire-up guide. Fill in repository URL and publisher ID in pyproject.toml.
84 lines
2.5 KiB
Markdown
84 lines
2.5 KiB
Markdown
# ComfyUI Block Bypass Switch
|
|
|
|
A custom node pack for ComfyUI that lets you **bypass or mute entire node groups with a single click** — no rewiring needed.
|
|
|
|
## Features
|
|
|
|
| Feature | Description |
|
|
|---------|-------------|
|
|
| **⚡ Block Bypass Switch** | Node that routes your signal either through a block or directly around it via a one-click toggle |
|
|
| **⚡ Group Bypass (Right-click)** | Right-click any group on the canvas to bypass, mute, or activate all nodes inside it |
|
|
| **⚡ Group Bypass Panel** | Floating panel with a dropdown listing all groups — apply Bypass / Mute / Activate in one click |
|
|
|
|
## Installation
|
|
|
|
### Option A — ComfyUI Manager (recommended)
|
|
1. Open **ComfyUI Manager**
|
|
2. Search for `Block Bypass Switch`
|
|
3. Click **Install** and restart ComfyUI
|
|
|
|
### Option B — Manual
|
|
1. Clone or download this repository
|
|
2. Copy the `comfyui-block-bypass` folder into your `ComfyUI/custom_nodes/` directory
|
|
3. Restart ComfyUI
|
|
|
|
## Usage
|
|
|
|
### Block Bypass Switch Node
|
|
|
|
Find it under **`utils/bypass`** → **`⚡ Block Bypass Switch`**
|
|
|
|
Wire it up like this:
|
|
|
|
```
|
|
[Node Before Block] ──► direct_in ──┐
|
|
├──► output ──► [Rest of workflow]
|
|
[Block Output] ──► block_out ──┘
|
|
|
|
bypass = ON → signal goes around the block (direct_in)
|
|
bypass = OFF → signal goes through the block (block_out)
|
|
```
|
|
|
|
| Input | Type | Description |
|
|
|-------|------|-------------|
|
|
| `direct_in` | ANY | Signal **before** your block |
|
|
| `block_out` | ANY | Signal **after** your block |
|
|
| `bypass` | BOOLEAN | ON = skip block · OFF = use block |
|
|
|
|
| Output | Type | Description |
|
|
|--------|------|-------------|
|
|
| `output` | ANY | The selected signal |
|
|
|
|
---
|
|
|
|
### Group Bypass Panel
|
|
|
|
After installing, a **`⚡ Gruppen`** button appears at the **bottom center** of your ComfyUI window.
|
|
|
|
1. Click **`⚡ Gruppen`** to open the panel
|
|
2. Select a group from the dropdown
|
|
3. Click one of:
|
|
- **⚡ Bypass** — skip all nodes in the group
|
|
- **🔇 Mute** — mute all nodes in the group
|
|
- **✅ Aktiv** — re-enable all nodes in the group
|
|
4. Use **↻** to refresh the list after renaming groups
|
|
|
|
---
|
|
|
|
### Right-click Group Menu
|
|
|
|
Right-click directly on any group frame on the canvas for quick access:
|
|
- **⚡ Gruppe bypassen** / **✅ Gruppe aktivieren**
|
|
- **🔇 Gruppe muten** / **✅ Gruppe aktivieren**
|
|
|
|
---
|
|
|
|
## Compatibility
|
|
|
|
- ComfyUI (new frontend, Node Spec 2.0)
|
|
- Automatic fallback for legacy ComfyUI versions
|
|
|
|
## License
|
|
|
|
[MIT](LICENSE)
|