ComfyUI-Fast-Group-Bypasser-Linked

KO | EN

gitlite — search

#hacktoberfest #typescript #go #golang #android #rust #nodejs #java #awesome #cli #kubernetes #security #ios #open-source

ComfyUI-Fast-Group-Bypasser-Linked

(★ 10)

New linking behaviors for rgthree's Fast Groups Bypasser and Fast Groups Muter nodes

ComfyUI-Fast-Group-Bypasser-Linked Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Fast Groups Bypasser - Linked & Alternate Extension

This single JavaScript file adds three new linking behaviors to
rgthree's **Fast Groups Bypasser** and **Fast Groups Muter** nodes,
without modifying any existing files and without requiring a build step.

---

## Installation

### Method 1: ComfyUI Registry / Manager (Recommended)
* Search for **Fast Groups Bypasser - Linked & Alternate** in the ComfyUI Manager and click Install.
* Alternatively, install via Comfy-CLI: `comfy-cli node install comfyui-fast-group-bypasser-linked`

### Method 2: Manual Git Clone
Clone this repository directly into your `ComfyUI/custom_nodes/` directory:
```bash
git clone https://github.com/RiverSide71/ComfyUI-Fast-Group-Bypasser-Linked.git
```
*(Note: Do **not** place this repository inside the `rgthree-comfy` folder. ComfyUI will automatically detect the extension globally).*

2. Restart ComfyUI completely (no browser-cache clear needed, but doesn't hurt).

That's it! - the extension auto-loads alongside the existing rgthree nodes.

---

## New Properties

After installation, right-click any **Fast Groups Bypasser** or
**Fast Groups Muter** node and open **"Properties"** (or "Properties Panel").
You will find three new fields:

| Property | Behavior |
|---|---|
| `groupLinks` | When Group A is toggled, Group B mirrors the **same** state. Multiple groups can be linked|
| `groupAlternates` | When Group A is toggled ON, Group B is forced OFF, and vice-versa. Multiple groups can be alternates of the other. Groups alternate in the sequence they are entered. |
| `groupExclusive` | When Group A is toggled ON, Group B is forced OFF, and vice-versa. Both may be OFF at the same time, but never both ON. Multiple groups can be in a group exclusive relationship.|

### Syntax

All three fields use the same format:

```
GroupName:OtherGroupName, ThirdGroup:FourthGroup, Stage1:Stage2:Stage3:Stage4
```
- Pairs and Lists are separated by **commas**.
- The group names in the link are separated by a **colon** (`:`).
- **Capitalization and spaces must match** your actual group titles exactly.
- All three, `groupLinks`, `groupAlternates` and `groupExclusive` are **bidirectional** - you only
  need to list each pair once (A:B automatically covers B:A as well).

---

## Feature 1 - Linked Groups

> *"When one group is bypassed/enabled, the other(s) is(are) also bypassed/enabled."*

### Example

You have two groups that have Load Image and Image Resize nodes in them. You always want to use them together and when not using them, you want them to share the same bypass state:

```
groupLinks = "Load Image:Image Resize"
```

Now if you click the **Load Image** group toggle to bypass it, **Image Resize** group is automatically bypassed too. Click **Load Image** to enable it, and **Image Resize** enables as well.

### Multiple linked pairs example

```
groupLinks = "Base Model:Refiner, Upscale:Hires Fix"
```

### Several linked groups example

```
groupLinks = "Group A:Group B:Group C:Group D, Group E:Group F:Group G"
```

---

## Feature 2 - Alternate Groups

> *"When one group is bypassed, the other(s) is(are) enabled, and vice-versa."*

This is the "XOR switch" pattern: exactly one of the two(or many) groups should be
active at any given time.

### Example

You want to toggle between **Load Checkpoint** and **GGUF Loader** - only one
should ever be active:

```
groupAlternates = "Load Checkpoint:GGUF Loader"
```

Clicking **Load Checkpoint** ON automatically bypasses **GGUF Loader** (and
vice-versa).

### Multiple alternate pairs example

```
groupAlternates = "Load Video:Load Image, Save Video:Save Image"
```

### Several alternate groups example

```
groupAlternates = "Load Video:Load Image:Load Webcam"
```
Enabling any member disables all others in the set. Disabling the active member enables the NEXT member in the defined order (circularly), so at least one is always ON.

## Feature 3 - Exclusive Groups

> *"Both(or all) groups cannot be turned on at the same time. Either one group is enabled, or both(all) are disabled."*

This is the "NAND switch" pattern: while both(or all) groups are in a groupAlternates link. Both(or all) can sit in the OFF state simultaneously. This is the precise distinction from groupAlternates, which always forces the inverse regardless of direction.

### Example

You want to toggle between **LoRa Pack A** and **LoRa Pack B** - only one should ever be active, however, both can be turned off for you to try generating without any LoRa.

```
groupExclusive = "LoRa Pack A:LoRa Pack B"
```

Clicking **LoRa Pack A** ON turns **LoRa Pack B** OFF and vice versa. It is also possible to turn **LoRa Pack A** OFF, keeping **LoRa Pack B** OFF as well.

### Multiple exclusive pairs example

```
groupExclusive = "LRA Pack A:LoRa Pack B, Style A:Style B"
```

### Several exclusive groups example

```
groupExclusive = "Style X:Style Y:Style Z", "LoRa Pack A:LoRa Pack B:LoRa Pack C"
```

---

##  Relationship Semantics Summary

```
┌─────────────┬─────────────────────────────┬────────────────────────────┐
│             │       Source turns ON       │      Source turns OFF      │
├─────────────┼─────────────────────────────┼────────────────────────────┤
│ LINKED      │ All others → ON             │ All others → OFF           │
│ ALTERNATE   │ All others → OFF            │ Circular-next member → ON  │
│ EXCLUSIVE   │ All others → OFF            │ (no change to others)      │
└─────────────┴─────────────────────────────┴────────────────────────────┘
```

## Combining Properties

You can use `groupLinks` and `groupAlternates` on the **same node** at the
same time, as long as a group name only appears in one of the two maps
(putting the same pair in both would create contradictory instructions).

---

## Compatibility Notes

| Updating rgthree-comfy | ✅ Safe | This file is separate; rgthree updates won't touch it.|

| Nodes 2.0 (ComfyUI beta) | ⚠️ May break | rgthree itself has known issues with Nodes 2.0; disable it in ComfyUI settings if things look wrong. |

## General Notes

> *All three relationship types are per-node: two separate Bypasser nodes do not share state.

> *Works on both "Fast Groups Bypasser (rgthree)" and  "Fast Groups Muter (rgthree)".

---

## Troubleshooting

**The property fields don't appear in the Properties panel.**
: Restart ComfyUI. The extension must load before the graph shows.

**A link/alternate isn't working.**
: Open the browser console (F12 → Console). If a group name is misspelt or
  doesn't exist, a warning like
  
  `[rgthree-linked] Could not find linked group "My Group"` is logged.
  
  Check that the name in the property **exactly** matches the group title
  shown in the Bypasser widget (including capitalization and spaces).

**Both groups end up in the same state when they should alternate.**
: Make sure the pair is in `groupAlternates`, not `groupLinks`.

---

ComfyUI-Fast-Group-Bypasser-Linked

ComfyUI-Fast-Group-Bypasser-Linked Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ComfyUI-Fast-Group-Bypasser-Linked

ComfyUI-Fast-Group-Bypasser-Linked Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README