Nodes/Shima/Shima Breaker
ComfyUI Node

Shima Breaker

One switch to rule all the toggles in your workflow

By KDB-USJP·Created 6 months ago·Updated 6 months ago· 2
Shima Breaker
    • sync_state
    breaker_state0
    sync_mode0
    switch_automate
    scale1.0

    The Shima Breaker is what happens when someone decides a workflow needs a physical master switch - a big, satisfying toggle you can flip and watch whole sections of the graph go on or off. It's the master control for the pack's Panel Switch system: one Breaker broadcasts its state to every connected switch, so instead of clicking through a dozen little bypass toggles, you flip one. If you've ever wanted an "everything off except the thing I'm testing" button, this is it.

    How it works

    The Breaker outputs a single integer - sync_state, a 0 or 1 - that its companion Panel Switch nodes (and anything else wired to it) read. It has two operating modes, set by sync_mode:

    • Breaker mode (default) - every connected Panel Switch mirrors the Breaker's state. Flip the Breaker and the whole group flips with it.
    • Toggle mode - the Breaker inverts the state of the connected switches. Useful when you want one physical control that does the opposite of everything else.

    There's also switch_automate, a boolean input that overrides the physical state - that's how you drive the whole thing programmatically from another node, rather than by hand. The backend's execute even returns the state in its UI payload so the frontend can keep the switch animation in sync.

    Important framing: the Breaker itself doesn't hold any data. Its job is to be the shared source of the state signal. The actual bypassing - cutting a wire so a downstream node is muted - is done by the Panel Switch nodes sitting inline, which the docs describe as the "physical switch" receiving this state. Think of the Breaker as the fuse box and the Panel Switches as the individual circuits.

    The inputs that matter

    • breaker_state - 0 or 1, the physical toggle position.
    • sync_mode - 0 (Breaker mode) or 1 (Toggle mode). Set this once and leave it.
    • switch_automate - optional boolean that overrides the toggle.
    • scale - purely cosmetic; how big the rendered switch is on canvas (0.1–10).

    The single output, sync_state (INT), is what you wire to your Panel Switches or use to drive any other node that wants a 0/1.

    Installing it

    Part of the Shima pack - ComfyUI Manager → search Shima, or:

    cd ComfyUI/custom_nodes
    git clone https://github.com/KDB-USJP/shima_wf.git Shima
    

    Restart ComfyUI. First launch auto-installs the pack's deps and companion repos (ComfyUI-Impact-Pack, cg-use-everywhere).

    Common issues

    • "I flipped it and nothing happened." The Breaker only broadcasts state; the actual muting is done by Panel Switch nodes that consume it. If you don't have Panel Switches wired to the sync_state output, the Breaker is just a pretty switch.
    • Mode confusion - if connected switches do the opposite of what you expect, you're in Toggle mode. Flip sync_mode to 0 for mirror behavior.
    • It's a frontend-driven node. The visual bypass logic lives in the JavaScript layer, so if you've got the pack's JS disabled or a frontend issue, the switch may render but not act.

    The Breaker is at its best in a workflow with several toggleable paths - optional ControlNet branches, a bypassable upscale chain, A/B prompt variants - where being able to kill them all from one physical-looking control is genuinely nicer than hunting through the graph.

    CategoryShima/Routing

    Inputs (4)

    NameTypeDefaultDescription
    breaker_stateINT00–1
    sync_modeINT00–1
    switch_automateoptBOOLEAN
    scaleoptFLOAT1.00.1–10

    Outputs (1)

    NameTypeDescription
    sync_stateINT