Nodes/ComfyUI-StatusBarOverlay/Batch Status Bar Overlay
ComfyUI Node

Batch Status Bar Overlay

Label every image in a batch with its own caption

By muskccat·Created 3 months ago·Updated 3 months ago· 0
Batch Status Bar Overlay
  • image
  • status_list
  • image
bar_height30
bar_color#FFFFFF
text_color#000000
font_size18
x8
y5
alignleft
font_path

Status Bar Overlay stamps the same text on every image you feed it. Batch Status Bar Overlay is the version for when each image in the batch needs its own caption - which is exactly what a parameter sweep produces. Give it an image batch plus a matching list of strings, and it draws a status bar onto every frame using that frame's own text.

It's the middle act of this pack's intended workflow: KSampler Multi Run generates the sweep and emits a status_list, VAEDecode turns the latent batch into images, this node paints each image's status line onto it, and Batch Image Grid stacks them into one picture. On its own it's perfectly usable anywhere you have a batch and a per-image list of labels - a batch of style variations with their own prompts, say.

How it works

Mechanically it's the same Pillow code as the single-image Status Bar Overlay: fill the top bar_height pixels with bar_color, draw the text at x/y in text_color. The only difference is the status_list input. Instead of one string, it's a VALUE_LIST of strings, and the node reads entry n when labeling image n. One bar and one caption per frame, same styling across the whole batch. No model, no weights - the pack's only dependency is Pillow, which ComfyUI already bundles.

The inputs that matter

  • status_list - the per-image captions, and the one input without a sane default. Wire it to KSampler Multi Run's status_list output, or anything else that produces a VALUE_LIST.
  • bar_height (default 30), font_size (18), bar_color (#FFFFFF), text_color (#000000) - the styling. Sensible as shipped.
  • align (left/center/right) and x/y - text placement, same semantics as the single version.
  • font_path - the optional real-font escape hatch; without it, systems lacking arial get Pillow's tiny default font.

The output is a single IMAGE, same batch size as the input. Feed it straight into Batch Image Grid.

Install

Via ComfyUI Manager (search "StatusBarOverlay"), or:

cd ComfyUI/custom_nodes
git clone https://github.com/muskccat/ComfyUI-StatusBarOverlay

then restart. The only declared requirement is Pillow, which is already there, so there's nothing to babysit.

Troubleshooting

The one hard failure mode is a mismatch: if status_list has fewer entries than the image batch, the node throws a clear error rather than guessing. So if you're labeling a KSampler Multi Run output, make sure the batch you decode matches the batch it produced - an upstream filter node that drops frames will break the pairing. Beyond that, the usual font note applies: if the text looks wrong, set font_path to a real .ttf/.otf.

It's not a flashy node, and this pack doesn't exactly light up the community. But it's the piece that turns a wall of unlabeled sweep images into something you can actually read - and if you've ever re-run a batch because you couldn't tell which image had which setting, you'll get why it exists.

Categoryimage/overlay

Inputs (10)

NameTypeDefaultDescription
imageIMAGE
status_listVALUE_LIST
bar_heightINT301–512
bar_colorSTRING#FFFFFF
text_colorSTRING#000000
font_sizeINT181–256
xINT80–4096
yINT50–4096
alignCOMBOleft3 options: left, center, right
font_pathoptSTRING

Outputs (1)

NameTypeDescription
imageIMAGE