Nodes/AUN ComfyUI Nodes/Manual/Auto Image Switch
ComfyUI Node

Manual/Auto Image Switch

Manual mode that shows you what you're getting, before you queue it

By loz2754·Created 8 months ago·Updated about 24 hours ago· 5
Manual/Auto Image Switch
  • image
  • Filename
  • ManualName
  • Name Mode
  • image
Filename
width512
height512
ManualName
name_modetrue
show_overlaytrue
overlay_textNo image loaded
background_color181818
text_colorE6E6E6
box_color000000

The problem this node solves is one you only hit when your workflow has built up to a certain size: you've got an automatic filename pipeline feeding your saver, and sometimes you just want to name the output yourself - but flipping that means swapping a whole subgraph of switches, and while you're at it, what image is even going to come out? AUNManualAutoImageSwitch collapses that whole manual/auto decision into one node, and adds a trick the pure text switches don't: in Manual mode it returns a placeholder image so your preview doesn't lie to you.

How it works

It's a 2-in-1. In Auto mode (the default), it passes the connected image and the automatically generated Filename straight through - a pure pass-through, no surprises. Flip name_mode to Manual and it does two things: it uses your ManualName string instead of the auto filename, and it stops passing your image through, generating a blank placeholder image sized from width/height instead.

That placeholder is the clever part. If you've ever queued a workflow in manual mode with a stale image still wired to your preview, you know the confusion. Here, the blank image is the signal - with show_overlay on, it renders centered placeholder text (overlay_text) in a box, all color-controlled by background_color, text_color, and box_color (hex strings like 181818). The overlay is drawn client-side, which is why the node mentions a right-click AUN menu for overlay controls. So when manual mode is active, you see manual mode. There's no way to forget.

Inputs and outputs that matter

The three that matter for a beginner: name_mode (Auto vs Manual), image (pass-through source), and ManualName (what you want to call the output when manual). The width/height and the color/overlay widgets only bite in Manual mode.

Outputs:

  • Filename - the auto filename in Auto mode, empty or unused in Manual.
  • ManualName - your manual name, so downstream filename builders can use it.
  • Name Mode - a BOOLEAN mirroring the mode, which is the useful one: wire it into a switch so related nodes (like a saver's naming) flip in sync.
  • image - the pass-through source in Auto, the blank placeholder in Manual.

Installing it

Part of the AUN pack, so one install covers all of its nodes:

  • ComfyUI Manager: search "AUN ComfyUI Nodes", install, restart.
  • Manual: cd custom_nodes && git clone https://github.com/loz2754/AUN-ComfyUI-Nodes, then restart.

Cloned by hand and getting ModuleNotFoundError: cv2? pip install -r custom_nodes/AUN-ComfyUI-Nodes/requirements.txt sorts it.

Common issues

The main trap is a mismatch between what this node outputs and what downstream nodes expect. In Manual mode the image is a blank placeholder - that's intended, but if you've connected the output to a saver that writes whatever it receives, you'll save blank images. That's the design: the Name Mode boolean exists precisely so your saver can skip or swap based on the mode. Use it. And double-clicking the node body hides widgets into compact mode, so if it suddenly looks like your settings vanished, that's not a bug - that's AUN.

CategoryAUN Nodes/Image

Inputs (11)

NameTypeDefaultDescription
imageIMAGEImage to pass through when Name Mode is Auto.
FilenameSTRINGThe automatically generated filename.
widthINT5121–8192Width of the blank image returned when Name Mode is Manual.
heightINT5121–8192Height of the blank image returned when Name Mode is Manual.
ManualNameSTRINGA manually specified name to use instead of the automatic filename.
name_modeBOOLEANtrueAuto passes through the image and Filename. Manual returns a blank image and uses ManualName.
show_overlayBOOLEANtrueShow a centered placeholder label on the blank Manual-mode image.
overlay_textSTRINGNo image loadedCentered text shown on the blank Manual-mode image.
background_colorSTRING181818Blank image background color as hex, for example 181818 or #181818.
text_colorSTRINGE6E6E6Overlay text color as hex, for example E6E6E6 or #E6E6E6.
box_colorSTRING000000Overlay box color as hex, for example 000000 or #000000.

Outputs (4)

NameTypeDescription
FilenameSTRING
ManualNameSTRING
Name ModeBOOLEAN
imageIMAGE