ComfyUI Node

Mode Relay

Cascade mute/bypass across groups, without wiring every node

By r-vage·Created 10 months ago·Updated a day ago· 31
Mode Relay
    • oc

    Mode Relay is the node that lets you mute or bypass a whole group of nodes by changing the mode of one node, and then chain that control onward to other groups. If you've used rgthree's Fast Groups Muter/Bypasser (and the KB documents how central that idea is to keeping big graphs workable), this is this pack's reimplementation of the same instinct, rewritten for ComfyUI's newer V3/Nodes 2.0-era API - the frontend rewrite that notoriously broke the original rgthree group-mute rendering is exactly the reason packs like this one ship their own.

    The relay's special sauce, compared to the Mute / Bypass Repeater: the Repeater propagates its mode only to connected input nodes, and the two behaviors (group-wide vs connected) are mutually exclusive. The Relay does both at once, always. It propagates its mode to every node in its overlapping group (the canvas group it sits inside) and to any nodes connected to its inputs - no exclusivity switch to forget. One node, both behaviors, all the time.

    How it works

    Like every node in this pack's mode-control family (Mode Bridge, Fast Mode Switcher/Toggle, Node Collector, the Repeater), it's a virtual node: the Python side returns None and the real logic lives in the frontend JS. You place it inside a group on the canvas, and when you flip it to Mute or Bypass, everything sharing that group flips with it. The oc output lets you chain it onward - connect it to a Repeater, another Relay, or a Fast Muter/Bypasser to cascade control across several groups in sequence. That's the pattern the node description is pointing at when it says "Connect to a Repeater for cascading control across multiple groups."

    The inputs that matter

    None to configure - no widgets, no data sockets beyond the oc chaining output. The whole node is: place it in a group, right-click to change its mode, watch the group follow.

    Install

    Part of ComfyUI_Eclipse (r-vage). ComfyUI Manager, search ComfyUI_Eclipse, or:

    cd ComfyUI/custom_nodes
    git clone https://github.com/r-vage/ComfyUI_Eclipse
    

    Restart ComfyUI - these frontend-driven mode nodes need the restart before the JS registers, so a workflow reload isn't enough. No models, no heavy deps. If a shared [Eclipse] workflow won't load, the pack's v4.0 dropped legacy node IDs after the RvTools_v2 rename - run the Workflow Migration Tool.

    Common issues

    "The relay did nothing" - check it's actually inside the group whose nodes you expect it to control; "overlapping group" means the node shares the canvas group region, so a relay sitting outside the group's bounds controls nothing. "It muted the group but not the chain" - the oc chaining output is optional; without a connection onward, the cascade stops at this relay. And the conceptual gotcha shared by the whole family: this toggles mute/bypass state, not data. If you expected it to change a value, you've got the wrong tool - which, honestly, is the one "wrong tool" mistake that shows up whenever people discover these nodes.

    Category🌒 Eclipse/ Tools

    Inputs (0)

    No inputs

    Outputs (1)

    NameTypeDescription
    oc*Connect to Repeater, another Relay, or Fast Muter/Bypasser.