Nodes/Shima/Shima Image Pass
ComfyUI Node

Shima Image Pass

An airport at the edge of your island — image in, image out

By KDB-USJP·Created 6 months ago·Updated 6 months ago· 2
Shima Image Pass
  • image
  • mask
  • image
  • mask

Shima Image Pass is a passthrough node: an IMAGE goes in, the same IMAGE comes out, with an optional MASK riding along. If that sounds like a node that does nothing, you're right - and that's the point. It's a "Passer," and in Shima's island system passers are load-bearing.

Here's the context. Shima's workflows are built from "islands" - self-contained workflow fragments that auto-connect through the Use Everywhere broadcast system (cg-use-everywhere). When you enable allow_external_linking on a node, its outputs broadcast to matching inputs across the island. Passer nodes sit at the edges of those islands as stable connection points. The pack's own concepts doc spells it out: passers' optional inputs "prevent ComfyUI's auto-wiring from incorrectly connecting mismatched types, while still being valid targets for UE broadcasts. Think of them as stable 'airports' at the edge of each Island."

So the practical value is: you place an Image Pass where you want an image signal to reliably land or leave an island, and UE broadcasts find it without you drawing a single wire across the graph. Inside the node, execute just returns (image, mask) - a pure no-op - because the value is in placement, not computation.

The interface

  • image - optional IMAGE, out the other side unchanged.
  • mask - optional MASK, passed through in parallel. This is the reason the node is named plural: it carries the image and its mask together, so a masked workflow can cross an island boundary without the mask wandering off.
  • Outputs: image and mask, one-to-one.

Install

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

then restart, or ComfyUI Manager → search "Shima". No models, no extra dependencies.

Should you use it?

Honest answer: if you're hand-wiring a normal ComfyUI graph, this node is pure ceremony - the same trick exists in other packs' reroute nodes, and core ComfyUI handles passthrough natively. But if you're building Shima island workflows that auto-connect via UE, the passers are the glue that makes the broadcast system behave: they give broadcast targets a stable, correctly-typed socket so ComfyUI doesn't guess wrong. The mask companion is a real bonus over a bare reroute, since image+mask pairs are everywhere in inpainting and compositing pipelines. Just don't reach for it outside the island system; it'll work, but you're adding a node that does nothing for a graph that already does wiring by hand.

CategoryShima/Utilities/Passers

Inputs (2)

NameTypeDefaultDescription
imageoptIMAGE
maskoptMASK

Outputs (2)

NameTypeDescription
imageIMAGE
maskMASK