Nodes/AUN ComfyUI Nodes/AUN Image Title Multi Preview
ComfyUI Node

AUN Image Title Multi Preview

Label every frame of a batch right on the preview, without squinting

By loz2754·Created 7 months ago·Updated about 8 hours ago· 5
AUN Image Title Multi Preview
  • images
    show_labelstrue
    filenames
    label_positionbottom
    font_scale0.035
    label_height_scale1.8
    font_colorwhite
    bg_color#222222
    text_aligncenter

    Run a batch of 8 and you get a strip of 8 images that all look 95% identical, and the one you actually liked is the third from the left - if you can still tell which one that was. AUNImageTitleMultiPreview fixes the naming problem in the cheapest possible way: it draws a filename label as a bar outside the image, one label per frame, so each preview carries its own name. If you only ever generate one image at a time this is overkill. If you batch, it's quietly indispensable.

    Feed it an IMAGE tensor - a single (1,H,W,C) image or a batched (B,H,W,C) set - and it renders each frame with a label bar below (or above) it. The filenames input is the clever bit: one filename per line, newline-separated, and frame i of the batch gets line i of the labels. Leave it empty and you get the preview with no text in the bar, which is a perfectly fine plain-preview node too. Extra labels past the frame count are ignored; frames past the label count just get an empty bar.

    The knobs you'd actually touch: label_position (bottom or top), font_scale (default 0.035, i.e. text is 3.5% of the image height - sizing relative to height is why labels stay proportional when you jump between 512px and 1536px renders), and label_height_scale (bar height as a multiple of the font's pixel size). font_color, bg_color and text_align are there when the default dark bar with white centered text clashes with something. show_labels is the master switch - off, and images pass through with no overlay at all.

    There are no outputs. It's a terminal preview node, so it sits at the end of a wire (or fans out from a batch) and you just look at it.

    Where it shines: feeding it the filename/sidecar output from the AUN save nodes so your preview literally shows the generated filename, or pairing it with a String List of prompts so you can tell which batch frame came from which prompt. It's the low-friction sibling of AUNShowTextWithTitle - same "name the thing you're looking at" instinct, applied to pixels.

    Install: ComfyUI Manager (search "AUN"), or cd ComfyUI/custom_nodes && git clone https://github.com/loz2754/AUN-ComfyUI-Nodes, then restart. If a manual install throws ModuleNotFoundError: cv2 or piexif, the pack's requirements.txt has the fix.

    Troubleshooting:

    • No text in the label bar → filenames is empty, or the batch has more frames than you have lines.
    • Labels look enormous/tiny → adjust font_scale (it's a fraction of image height, not pixels).
    • You don't need labels at all this run → flip show_labels off; the preview stays, the overlay goes.
    CategoryAUN Nodes/Image

    Inputs (9)

    NameTypeDefaultDescription
    imagesIMAGESingle image (1,H,W,C) or batched images (B,H,W,C).
    show_labelsBOOLEANtrueWhen disabled, images pass through without any label overlay.
    filenamesoptSTRINGFilename for each image in the batch, one per line. Leave empty for no text in the label bar.
    label_positionoptCOMBObottomPlace the label bar below or above the image.
    font_scaleoptFLOAT0.0350.005–0.2Font size as fraction of image height (e.g., 0.035 = 3.5%). Consistent text sizing across different resolutions.
    label_height_scaleoptFLOAT1.81–5Label bar height as a multiple of the computed font pixel size.
    font_coloroptCOMBOwhiteColour of the label text.
    bg_coloroptCOMBO#222222Background colour of the label bar.
    text_alignoptCOMBOcenterHorizontal alignment of the label text within the bar.

    Outputs (0)

    No outputs