Nodes/ComfyAngel/Image Bridge πŸͺ½
ComfyUI Node

Image Bridge πŸͺ½

The loop node you'll forget to add and instantly regret

By ThepExcelΒ·Created 8 months agoΒ·Updated about a month agoΒ· 14
Image Bridge πŸͺ½
  • image
  • image
β—„modepreviewβ–Ί
β—„filename_prefixComfyAngelβ–Ί
β—„save_metadatatrueβ–Ί

Image Bridge πŸͺ½ is the most boring node in ComfyAngel and the one you'll miss the most. It's a pass-through: image in, same image out, with a preview or save along the way. That sounds like nothing, but inside a loop it's everything - it's the node that lets you actually see each iteration's result instead of staring at a frozen canvas while a 20-item loop runs in the dark. The README calls it essential for loops, and that's not marketing; skip it and your first loop will feel broken.

What it does

Two modes:

  • preview (default) - shows the image like a Preview Image node. Inside a loop, you see every pass as it completes.
  • save - writes a PNG to ComfyUI's output folder with a counter-suffixed filename built from filename_prefix (ComfyAngel_00001.png, etc.).

The save_metadata toggle (on by default) embeds the prompt and workflow into saved PNGs, same as the official Save Image - so a saved loop output is still drag-back-into-ComfyUI reproducible. The image passes through unchanged: it's the one node that can preview a batch without altering it, and since v0.6.0 it handles batches of differently-sized images by previewing them padded but outputting the originals untouched.

Why the loop pairing matters

ComfyUI's preview nodes are output nodes - they mark the end of a branch and force execution. Inside a dynamic loop, that's exactly what you need: a visible check that each iteration produced something worth keeping, mid-run, without stopping the loop. The pack's own loop recipe is Loop Start β†’ sampler β†’ Image Bridge β†’ Loop End. Put it after the VAE decode inside the loop and you'll watch every result roll by.

One quirk to know: the output is a list of tensors (the node splits batches into individual images internally), so it feeds naturally into loop machinery and list-aware nodes. If something downstream insists on a single IMAGE tensor, you may need a list-handling node or a batch-aware consumer - that's the one friction point.

Installing it

cd ComfyUI/custom_nodes
git clone https://github.com/ThepExcel/ComfyAngel.git

Restart ComfyUI, or search "ComfyAngel" in ComfyUI Manager. Dependency footprint is just Pillow; no model files.

Honestly, the biggest "troubleshooting" for this node is remembering it exists. You'll build a loop without it, run it, see nothing happen for a full minute, and go "wait, did it hang?" - it didn't; it just had nowhere to show you anything. Drop a Bridge in preview mode inside the loop and the whole experience changes. In save mode, remember the counter resets per run but never overwrites - you get _00001, _00002… forever, which is exactly what you want from a batch.

CategoryComfyAngel/Utility

Inputs (4)

NameTypeDefaultDescription
imageIMAGEβ€”
modeCOMBOpreview2 options: preview, save
filename_prefixoptSTRINGComfyAngelβ€”
save_metadataoptBOOLEANtrueβ€”

Outputs (1)

NameTypeDescription
imageIMAGEβ€”